NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #570 most downloaded on Packagist
Browser controller/emulator abstraction for PHP
Latest stable
v1.13.0
Last release 1 years ago
22 Nov 2025
Release timing varies
gaps range from 6 weeks to 4.0 years
Some releases are documented
notes for 11 of 26 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
26 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
Added support for symfony/css-selector 8
New features:
symfony/css-selector 8DriverInterface methodsTestsuite:
Explicitly mark method parameters with null default values as nullable to avoid deprecation notice in PHP 8.4
Bug fixes:
null default values as nullable to avoid deprecation notice in PHP 8.4Added support for symfony/css-selector 7
Your coding agent can read these notes before it upgrades. Set up the MCP server →
New features:
symfony/css-selector 7Testsuite:
Added support for symfony/css-selector 6
New features:
symfony/css-selector 6WebAssert::elementAttributeNotExistsRemoved:
symfony/css-selector <4.4Bug fixes:
New features:
symfony/css-selector 6WebAssert::elementAttributeNotExistsRemoved:
symfony/css-selector <4.4Bug fixes:
Fixed deprecation warnings on PHP 8.1
New features:
Element::waitForRemoved:
Testsuite:
Fixed the phpdoc of NodeElement::getValue . This method actually returns null in some cases (unchecked checkbox for instance)
Bug fixes:
NodeElement::getValue. This method actually returns null in some cases (unchecked checkbox for instance)Fixed the message when reporting the deprecation of ExpectationException::getSession()
New features:
visit. Mink::getSession() will no longer start the session automatically.symfony/css-selector 4 and 5Bug fixes:
ExpectationException::getSession()| inside strings or conditions rather than as a top-level unioncount on stringsTestsuite:
Driver testsuite:
mink/driver-testsuite to run driver tests instead.Misc:
Boolean to boolean to be compatible with psalm type checkingRefactored the CssSelector to use the new API of the Symfony CssSelector component to be compatible with Symfony 3
Bug fixes:
Testsuite:
Driver testsuite:
wait() always return a boolean even when the JS expression does not cast the valueMisc:
Passing an escaped locator is still supported but deprecated.
Session::getResponseHeader to access a response header easilyCoreDriver::findElementXpaths instead of implementing find and setSession themselves..phpsymfony/phpunit-bridge to get them reported when using Mink in your PHPUnit tests.NodeElement::hasClass in case the class attribute contains newlinesAdded a check for empty path in WebAssert::cleanUrl()
WebAssert::cleanUrl()Element::getSession has been deprecated and will be removed in 2.0. Code needing the session should get it from outside rather than from the element.
The main focus of this release is ensuring consistency between all driver implementations.
named_partial selector if you want to force doing a partial match.NodeElement::getValue for checkboxes now returns the value of the field when checked and null otherwise rather than the checked state (use NodeElement::isChecked for that)Element::getSession has been deprecated and will be removed in 2.0. Code needing the session should get it from outside rather than from the element.NodeElement::setValue to support any fields rather than only input elementsElement::getOuterHtml to get the HTML code of the element including itselfElement::waitFor to allow retrying some code until it succeeds or the timeout is reachedElement::isValid to check whether an element still exists in the pageSession::getWindowName and Session::getWindowNames to get the name of the current and of all windowsSession::maximizeWindow to maximize the windowNodeElement::isSelected to check whether an <option> is selectedNodeElement::submitForm to allow submitting a form without using a buttonSession::wait to return the condition value rather than nothingWebAssertBehat\Mink\Selector\Xpath\Escaper to allow reusing the XPath escaping. When building your own XPath, using it is prefered over accessing the SelectorsHandler for forward-compatibility with 2.0 (using the SelectorsHandler to escape the locator passed to the named selector is fine as this escaping will need to be removed in 2.0)hasClass from DocumentElement (instead of triggering a fatal error when it is used)placeholder only for textual inputsNodeElement::getTagName to ensure that the tag name is lowercase for all driversElement::hasAttribute to ensure it supports attributes with an empty valuefield selector to avoid matching inputs with the type submit or resetreset buttons as wellSession::executeScript compatible across drivers by ensuring they all support the same syntaxes for the JS expressionSession::evaluateScript compatible across drivers by ensuring they all support the same syntaxes for the JS expressionNothing 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
Nothing published for this version
One column per quarter.