NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1180 most downloaded on Packagist
Instrument headless chrome/chromium instances from PHP
Latest stable
v1.16.2
Last release 18 days ago
04 Nov 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 54 of 55 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
55 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Fix buffered events delaying responses by 50ms each
Pass explicit trim characters ahead of the PHP 8.6 trim default change
Promote the returned PageUtils helper classes to the public API
PageUtils helper classes to the public APINode::getPosition()referrer, referrerPolicy and transitionType in Page::navigate()Page::authenticate and Page::clearAuthentication methods for HTTP authentication challengesAbstractBinaryInput::saveToStream methodPage::screenshotElement()Mouse::move()Mouse::getPosition()chrome-php/wrench ^1.9Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix mouse scrolling timing out when the page changes during the scroll
Add support for using Symfony 8 components
CHROME_NO_SANDBOX env varSecurity fix for missing encoding in CssSelector
PageScreenshot::getExceptionCssSelectorSet maximal expires value if session=false in Page::setCookies
session=false in Page::setCookiesFix nullable parameter definition in AbstractBinaryInput::getRawBinary
AbstractBinaryInput::getRawBinaryAdd the ability to screenshot individual elements on the page
AbstractBinaryInput::getRawBinary methodCookie implement IteratorAggregate* Add PHP 8.3 support * Auto-detect Chromium too
Fixed encoding bugs in XPathSelector
XPathSelectorAdd Page::setScriptExecution method
Add Node::setHTML methodPage::setScriptExecution methodPage::waitForElementexcludedSwitches optionwebp format and optimizeForSpeed option in Page::screenshotFix rare crash in Page::getHtml
Page::getHtmlKeyboard::typeText()Added some additional life-cycle event constants
Fixed issue where Chrome 111 and later have different default allowed origins
Add helper function to find target
--crash-dumps-dir optionsetHtmlFix case where the timeout in setHtml() isn't respected
setHtml() isn't respectedDom classResponseReader classwaitForStartup if dev tools failed to startsendCloseMessageFix command execution in AutoDiscover
AutoDiscoverUse command to guess the chrome executable in Linux
command to guess the chrome executable in LinuxFix intermittency in Mouse::findElement()
Mouse::findElement()* Support Monolog 3
* Officially support PHP 8.1
Added Page::waitUntilContainsElement() method
Browser::getPages methodPage::waitUntilContainsElement() methodPage::setHtml() methodSelectorMouse::findElement() methodAdded fallback to css layout metrics
Node::querySelector from returning nodeId 0Added support for --no-proxy-server and --proxy-bypass-list
--no-proxy-server and --proxy-bypass-listPage::getHtmlNode::sendFiles methodFixed issues with Keyboard::typeText with multibyte strings
Keyboard::typeText with multibyte stringsMouse::find() after cursor has movedAdded support for setting HTTP headers
psr/log 2 and 3* Partial PHP 8.1 support
Dropped --disable-default-apps and --disable-extensions by default
--disable-default-apps and --disable-extensions by defaultPagePdf class to improve validation* Fix mouse element position
* Add DOM element locator
Fix mouse scroll maximum distance
Switched over to chrome-php/wrench
chrome-php/wrenchFix mouse scroll maximum distance
Fix scroll method returning prematurely
Added support for proxy servers as a direct option
getChromeVersion functionAttempt to auto-detect chrome binary path
Page::getHtmlsetDownloadPathcaptureBeyondViewportIncrease default sync timeout to 5 seconds
--font-render-hinting=none in headless modeWrench::connect() return valueFixed issues with Browser::close
Browser::closeAdded timeout for PageEvaluation methods
Page::pdfBrowser::closeEscaping custom flags for BrowserFactory is now automatic
BrowserFactory is now automaticPage::getFullPageClipgetBase64headerTemplate and footerTempalte for Page::pdfscale for Page::pdfAdded Page::pdf (thanks @tanasecosminromeo)
Enabled runtime events for pages
Load script tags on the page
Added Page::getLayoutMetrics that allows to take full page screenshots (#43 #44) thanks @kaero598
Page::getLayoutMetrics that allows to take full page screenshots (#43 #44) thanks @kaero598Page::getFullPageClip to ease full page screenshotsDo full page screenshots:
$page->screenshot([
'clip' => $page->getFullPageClip()
])
->saveToFile('/tmp/image.jpg');
> Make a crawl instance sharable among multiple scripts
Make a crawl instance sharable among multiple scripts
keepAlive for browser factory.BrowserProcess::getSocketUri and ProcessAwareBrowser::getSocketUridebugBrowserFactory::connectToBrowserFixed a race condition in target creations/destruction #38 (thanks @choval)
Added method Browser::setPagePreScript
Browser::setPagePreScriptPage::addPreScript"nosandbox" for browser factory"sendSyncDefaultTimeout" for browser factory"ignoreCertificateErrors" for browser factory"customFlags" for browser factoryPage info are now in sync with the browser
Page::getCurrentUrlPage.setCookies, Page.readCookies , Page.readAllCookiesPage::setUserAgent or via factory option userAgentMake viewport and window's size customizable
Make viewport and window's size customizable
windowSize in BrowserFactoryPage::setViewportSize and Page::setDeviceMetricsOverrideAdd constant Page::NETWORK_IDLE
* Features: * Add Page::close
Add PageEvaluation::waitForPageReload
Allow CHROME_PATH to have spaces in the path
Added CHROME_PATH detection for executables.
Added CHROME_PATH detection for executables.
Nothing published for this version
One column per quarter.