php-webdriver

Bugs:

• moveto fix broke php5 compatibilty issue (@phil-davis)

Bug Fixes:

• #118 - added a moveto() shim that instead throws UnknownError
• #122 - empty $parameters (array) replaced with {}

Maintenance:

• rework attribute() and css() to explicitly add their $parameters to URL

Bug Fixes:

• $session->focusWindow() - support handle parameter for W3C compatibility (Selenium 3.x & Firefox) (@mvorisek)

Bug Fixes

• moveto returns "unknown command" on v4.3.0 of chrome webdriver (@slava-v)

Maintenance

• fix Selenium 3 testing to keep it green (@mvorisek)
• add testing with mink/driver-testsuite (@mvorisek)
• improve readability when extracting from value/result
• assert curl payload is serializable (@mvorisek)
• check if webdriver command is obsolete
• add $session->isW3C() and flip the $legacy logic

Bug Fixes

• moveto returns "unknown command" on v4.3.0 of chrome webdriver (@slava-v)

Maintenance

• backport exceptions from master branch
• improve readability when extracting value/result

Changes:

• Fix compatibility with Selenium 2.x (@mvorisek)
• Assert curl data are always fully serialized before request (@mvorisek)
• Add testing with mink/driver-testsuite (@mvorisek)

WebDriver: W3C Editor's Draft 1 April 2022

• fix $element->shadow(): /session/:sessionid/element/:elementid/shadow (POST)
• add $session->getTimeouts(): /session/:sessionId/timeouts (GET)
• add $session->newWindow(): /session/:sessionId/window/new (POST)

Compat Busters

• $session->window() on legacy JSON Wire Protocol no longer closes a window; use $session->deleteWindow() instead
• $session->legacyWindow() from 2.0.0-BETA removed; $session->window() now returns Window or LegacyWindow objects for method chaining
• $session->execute() and $session->execute_async() wrap both the legacy JSON Wire Protocol and W3C Webdriver Protocol
• removed the $legacy parameter from constructors; this used to be the $w3c property from 2.0.0-RC4

Enhancements

• serialize/unserialize elements and shadow roots in execute() and execute_async() arguments and return value (@mvorisek)

Refactoring

• final keyword now only appears on classes that purely house consts
• renamed webDriverElement() to makeElement()
• renamed getElementPath() to getIdentifierPath()
• renamed W3C identifier consts , i.e., WEBDRIVER_ prefix is now WEB_

Housekeeping

• move boilerplate license to a separate file; compress the @copyright, @license, and @author tags
• update external links in README
• phpdocs, phpstan

Fixes @robocoder's b0rked refactoring in 1.4.12. Thanks @mvorisek

Enhancements:

• serialize/unserialize W3C web elements in execute and execute_async arguments and return value (@mvorisek)

Maintenance:

• README.md housekeeping
• phpstan cleanup

Backported error handling fixes from master branch

• move auto-init of curl service (@vibbow)
• php 7.4+ support (@MarvinKlar, @dhinakaran60, @GautierDig)
• update to WebDriver: W3C Editor's Draft 17 June 2021
• session initialization and W3C vs (legacy) WebDriver detection
• refactor Storage classes
• phpcs/phpstan cleanup

Changes:

• Travis CI configuration update
• Add "New Window" endpoint from W3C spec
• fix curl option array and w3c property (#105, @kadse)
• use response's capabilities (if returned) (#99, @GeraldWolfInvia)
• suppress "Transfer-Encoding: chunked" (#96, @mremi)
• tweak preg_quote() fix (refs #91, @stronk7)
• handle W3C in timeout abstraction (#88, @stof)
• fix W3C error strings (#87, @stof)
• add w3c property (#86, @stof)
• dependency injection (#73, @aik099)
• optional curl options, i.e., transient options (#53, @almostdaly)

• Fix error during legacy javascript execution (@shavounet and @CJMCT89)
• preg_replace() requires quoting, especially for PHP 7.3 (@stronk7)

Changes:

• Fixes legacy session->execute($jsonScript) - @stof

Reviewed changes to the latest Candidate Recommendation spec. November 24, 2017.

WebDriver W3C Candidate Recommendation 26 September 2017

Compat Busters

For newer web drivers that implement the WebDriver W3C candidate recommendation spec

• $session->window() now returns a WebDriver\Window object for method chaining
• $element->submit(), $element->equals(), $element->displayed(), $element->location(), $element->location_in_view() and $element->size() are unsupported; refer to $element->click(), $element->property(), and $element->rect()
• $session->keys(), $session->orientation(), $session->alert_text(), $session->dismiss_text(), $session->moveto(), $session->click(), $session->buttondown(), $session->buttonup(), $session->doubleclick(), $session->execute_sql(), $session->location(), $session->browser_connection(), $session->window_handle(), $session->window_handles(), and $session->execute_async() are unsupported; refer to $session->actions(), $session->alert(), and $session->execute()

For older web drivers still using the (legacy) JSON Wire Protocol:

• use $session->legacyWindow() instead of $session->window()

Fixes:

• Adds the "deleteJob" call implementation for SauceLabs REST API (@aik099)
• hack around broken SSL certs on saucelabs
• Always suppress "Expect: 100-continue" header (@c960657)
• make sure http errors from the requested resource are noticed (@gggeek)