NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #1323 most downloaded on Packagist
Instrument headless chrome/chromium instances from PHP
Last release 3 months ago
06 Jul 2026
Ships fairly regularly
a new release about every 4 months
Most releases are documented
notes for 39 of 54 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
54 releases · first in 2018
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.9One column per quarter.
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 IteratorAggregateAdd 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/wrenchNothing published for this version
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::pdfNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →