diff options
Diffstat (limited to 'CHANGES.md')
| -rw-r--r-- | CHANGES.md | 228 |
1 files changed, 107 insertions, 121 deletions
@@ -1,10 +1,63 @@ -Change log -========== +<!-- markdownlint-disable MD024 --> +# Change log All notable changes to this program are documented in this file. -0.30.0 (2021-09-16, `d372710b98a6`) ------------------------------------- +## 0.31.0 (2022-04-11, `b617178ef491`) + +### Known problems + +- _macOS 10.15 (Catalina) and later:_ + + Due to the requirement from Apple that all programs must be + notarized, geckodriver will not work on Catalina if you manually + download it through another notarized program, such as Firefox. + + Whilst we are working on a repackaging fix for this problem, you can + find more details on how to work around this issue in the [macOS + notarization] section of the documentation. + +### Added + +- Users with the [Rust] toolchain installed can now build and install + geckodriver from [crates.io] using Cargo: + + % cargo install geckodriver + +- Support for [Get Element Shadow Root] + + Implemented by [David Burns]. + + The standardised WebDriver [Get Element Shadow Root] endpoint provides a way + to retrieve the Shadow Root of a given web element. This endpoint is + supported by geckodriver when using Firefox version ≥96. + +- Support for additional hosts and origins + + Users can now specify a list of allowed `Host` and `Origin` headers for + incoming requests using the [`--allow-hosts`] and [`--allow-origins`] command + line options, respectively. When such a flag is provided, exactly the given + values will be permitted. + + By default any request with an `Origin` header is rejected, and only requests + containing the bound hostname (specified via `--host`), or an IP address, + in the Host header are allowed. These configuration options are + designed to support scenarios where geckodriver is running on a different + network node to the host e.g. some container based setups. + +### Fixed + +- Geckodriver lets Marionette itself select a system allocated port, so that + it's no longer required to specify a fixed port when using a custom Firefox + profile. This is done by reading the `MarionetteActivePort` file of the + Firefox profile in-use. This helps to avoid port collisions when multiple + Firefox instances are run in parallel. + +- It's no longer possible to specify both the `androidPackage` and `binary` + capabilities togther within [`moz:firefoxOptions`] because these capabilites + are mutually exclusive. + +## 0.30.0 (2021-09-16, `d372710b98a6`) ### Security Fixes @@ -85,9 +138,7 @@ All notable changes to this program are documented in this file. - The test root folder is now removed when geckodriver exists. - -0.29.1 (2021-04-09, `970ef713fe58`) -------------------------------------- +## 0.29.1 (2021-04-09, `970ef713fe58`) ### Known problems @@ -135,9 +186,7 @@ All notable changes to this program are documented in this file. anymore unless there is a strong reason. It will be removed in a future release. - -0.29.0 (2021-01-14, `cf6956a5ec8e`) ------------------------------------- +## 0.29.0 (2021-01-14, `cf6956a5ec8e`) ### Known problems @@ -176,8 +225,7 @@ All notable changes to this program are documented in this file. Note: For this experimental feature the site-isolation support of Firefox aka [Fission] will be not available. -0.28.0 (2020-11-03, `c00d2b6acd3f`) ------------------------------------- +## 0.28.0 (2020-11-03, `c00d2b6acd3f`) ### Known problems @@ -226,8 +274,7 @@ All notable changes to this program are documented in this file. - Since Firefox 72 extension commands for finding an element’s anonymous children and querying its attributes are no longer needed, and have been removed. -0.27.0 (2020-07-27, `7b8c4f32cdde`) ------------------------------------- +## 0.27.0 (2020-07-27, `7b8c4f32cdde`) ### Security Fixes @@ -291,18 +338,17 @@ All notable changes to this program are documented in this file. - _Android:_ - * Firefox running on Android devices can now be controlled from a Windows host. + - Firefox running on Android devices can now be controlled from a Windows host. - * Setups with multiple connected Android devices are now supported. + - Setups with multiple connected Android devices are now supported. - * Improved cleanup of configuration files. This prevents crashes if + - Improved cleanup of configuration files. This prevents crashes if the application is started manually after launching it through geckodriver. - Windows and Linux binaries are again statically linked. -0.26.0 (2019-10-12, `e9783a644016'`) -------------------------------------- +## 0.26.0 (2019-10-12, `e9783a644016'`) Note that with this release the minimum recommended Firefox version has changed to Firefox ≥60. @@ -384,9 +430,7 @@ has changed to Firefox ≥60. to start a session with a malformed capabilities configuration will now return the [`invalid argument`] error consistently. - -0.25.0 (2019-09-09, `bdb64cf16b68`) ------------------------------------ +## 0.25.0 (2019-09-09, `bdb64cf16b68`) __Note to Windows users!__ With this release you must have the [Microsoft Visual Studio redistributable runtime] @@ -478,9 +522,7 @@ with this particular release that we intend to release a fix for soon. `firefox` binary on Linux. Now it supports different BSD flavours as well. - -0.24.0 (2019-01-28, `917474f3473e`) ------------------------------------ +## 0.24.0 (2019-01-28, `917474f3473e`) ### Added @@ -520,7 +562,7 @@ with this particular release that we intend to release a fix for soon. To cross-compile from another host system, you can use this command: - % cargo build --target armv7-unknown-linux-gnueabihf + % cargo build --target armv7-unknown-linux-gnueabihf ### Changed @@ -548,9 +590,7 @@ with this particular release that we intend to release a fix for soon. - Fixed a regression in the [Take Element Screenshot] to not screenshot the viewport, but the requested element. - -0.23.0 (2018-10-03) -------------------- +## 0.23.0 (2018-10-03) This release contains a number of fixes for regressions introduced in 0.22.0, where we shipped a significant refactoring to the way @@ -604,9 +644,7 @@ geckodriver internally dealt with JSON serialisation. git repository is now limited to 12 characters, as it is when building from an hg checkout. This ensures reproducible builds. - -0.22.0 (2018-09-15) -------------------- +## 0.22.0 (2018-09-15) This release marks an important milestone on the path towards a stable release of geckodriver. Large portions of geckodriver @@ -681,17 +719,15 @@ to the standard. [Jeremy Lempereur]. - Many documentation improvements, now published on - https://firefox-source-docs.mozilla.org/testing/geckodriver/. - + <https://firefox-source-docs.mozilla.org/testing/geckodriver/>. -0.21.0 (2018-06-15) -------------------- +## 0.21.0 (2018-06-15) Note that with this release of geckodriver the minimum recommended Firefox and Selenium versions have changed: - - Firefox 57 (and greater) - - Selenium 3.11 (and greater) +- Firefox 57 (and greater) +- Selenium 3.11 (and greater) ### Added @@ -753,9 +789,7 @@ Firefox and Selenium versions have changed: - When stdout and stderr is redirected by geckodriver, a bug prevented the redirections from taking effect. - -0.20.1 (2018-04-06) -------------------- +## 0.20.1 (2018-04-06) ### Fixed @@ -769,9 +803,7 @@ Firefox and Selenium versions have changed: The regression should not have caused any functional problems, but the termination cause and the exit status are now reported correctly. - -0.20.0 (2018-03-08) -------------------- +## 0.20.0 (2018-03-08) ### Added @@ -815,9 +847,7 @@ Firefox and Selenium versions have changed: - Improved error messages for malformed capability values. - -0.19.1 (2017-10-30) -------------------- +## 0.19.1 (2017-10-30) ### Changed @@ -837,11 +867,10 @@ Firefox and Selenium versions have changed: - Removed obsolete `socksUsername` and `socksPassword` proxy configuration keys because neither were picked up or recognised - -0.19.0 (2017-09-16) -------------------- +## 0.19.0 (2017-09-16) Note that with geckodriver 0.19.0 the following versions are recommended: + - Firefox 55.0 (and greater) - Selenium 3.5 (and greater) @@ -903,9 +932,7 @@ Note that with geckodriver 0.19.0 the following versions are recommended: - `marionette.defaultPrefs.port` - `marionette.logging` - -0.18.0 (2017-07-10) -------------------- +## 0.18.0 (2017-07-10) ### Changed @@ -937,9 +964,7 @@ Note that with geckodriver 0.19.0 the following versions are recommended: - Linux x86 (i686-unknown-linux-musl) builds are fixed - -0.17.0 (2017-06-09) -------------------- +## 0.17.0 (2017-06-09) ### Added @@ -977,9 +1002,7 @@ Note that with geckodriver 0.19.0 the following versions are recommended: - Use [`SessionNotCreated`] error instead of [`UnknownError`] if there is no current session - -0.16.1 (2017-04-26) -------------------- +## 0.16.1 (2017-04-26) ### Fixed @@ -990,9 +1013,7 @@ Note that with geckodriver 0.19.0 the following versions are recommended: - Session is now ended when closing the last Firefox window (fixes [#613](https://github.com/mozilla/geckodriver/issues/613)) - -0.16.0 (2017-04-21) -------------------- +## 0.16.0 (2017-04-21) Note that geckodriver v0.16.0 is only compatible with Selenium 3.4 and greater. @@ -1078,9 +1099,7 @@ and greater. - Improved log messages to the HTTPD - -0.15.0 (2017-03-08) -------------------- +## 0.15.0 (2017-03-08) ### Added @@ -1106,9 +1125,7 @@ and greater. - Aligned the data structure accepted by the [Set Timeouts] command with the WebDriver specification - -0.14.0 (2017-01-31) -------------------- +## 0.14.0 (2017-01-31) ### Changed @@ -1125,9 +1142,7 @@ and greater. - HTTPD now returns correct response headers for `Content-Type` and `Cache-Control` thanks to [Mike Pennisi] - -0.13.0 (2017-01-06) -------------------- +## 0.13.0 (2017-01-06) ### Changed @@ -1148,9 +1163,7 @@ and greater. - Check for single-character key codes in action sequences now counts characters instead of bytes - -0.12.0 (2017-01-03) -------------------- +## 0.12.0 (2017-01-03) ### Added @@ -1194,17 +1207,13 @@ and greater. - Included capabilities example in the [README] - -0.11.1 (2016-10-10) -------------------- +## 0.11.1 (2016-10-10) ### Fixed - Version number in binary now reflects the release version - -0.11.0 (2016-10-10) -------------------- +## 0.11.0 (2016-10-10) ### Added @@ -1273,9 +1282,7 @@ and greater. which means a tab with an upgrade notice is not displayed when launching a new Firefox version - -0.10.0 (2016-08-02) -------------------- +## 0.10.0 (2016-08-02) ### Changed @@ -1292,9 +1299,7 @@ and greater. - Grammar fix in [README] - -0.9.0 (2016-06-30) ------------------- +## 0.9.0 (2016-06-30) ### Added @@ -1326,9 +1331,7 @@ and greater. - Introduced a changelog (this) - -0.8.0 (2016-06-07) ------------------- +## 0.8.0 (2016-06-07) ### Added @@ -1355,9 +1358,7 @@ and greater. - FIx typo in error message for parsing errors - -0.7.1 (2016-04-27) ------------------- +## 0.7.1 (2016-04-27) ### Added @@ -1380,9 +1381,7 @@ and greater. - Squash rustc 1.6 warnings by using `std::thread::sleep(dur: Duration)` - -0.6.2 (2016-01-20) ------------------- +## 0.6.2 (2016-01-20) ### Added @@ -1394,9 +1393,7 @@ and greater. - Enable CPOWs in Marionette - -0.6.0 (2016-01-12) ------------------- +## 0.6.0 (2016-01-12) ### Added @@ -1412,9 +1409,7 @@ and greater. - Update dependencies - -0.5.0 (2015-12-10) ------------------- +## 0.5.0 (2015-12-10) ### Changed @@ -1426,17 +1421,13 @@ and greater. - Update dependencies - -0.4.2 (2015-10-02) ------------------- +## 0.4.2 (2015-10-02) ### Changed - Skip compiling optional items in hyper - -0.4.1 (2015-10-02) ------------------- +## 0.4.1 (2015-10-02) ### Changed @@ -1444,9 +1435,7 @@ and greater. - Update dependencies - -0.4.0 (2015-09-28) ------------------- +## 0.4.0 (2015-09-28) ### Added @@ -1476,17 +1465,13 @@ and greater. - Fix example in documentation from @vladikoff - -0.3.0 (2015-08-17) ------------------- +## 0.3.0 (2015-08-17) ### Added - Add support for finding elements in subtrees - -0.2.0 (2015-05-20) ------------------- +## 0.2.0 (2015-05-20) ### Added @@ -1522,9 +1507,7 @@ and greater. - Handle null id for switching to frame more correctly - -0.1.0 (2015-04-09) ------------------- +## 0.1.0 (2015-04-09) ### Added @@ -1573,8 +1556,6 @@ and greater. - Squash compile warnings - - [README]: https://github.com/mozilla/geckodriver/blob/master/README.md [Browser Toolbox]: https://developer.mozilla.org/en-US/docs/Tools/Browser_Toolbox [WebDriver conformance]: https://wpt.fyi/results/webdriver/tests?label=experimental @@ -1586,8 +1567,11 @@ and greater. [Fission]: https://wiki.mozilla.org/Project_Fission [Capabilities]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Capabilities.html [Flags]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Flags.html +[`--allow-hosts`]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Flags.html#code-allow-hosts-var-allow-hosts-var-code +[`--allow-origins`]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Flags.html#code-allow-origins-var-allow-origins-var-code [enable remote debugging on the Android device]: https://developers.google.com/web/tools/chrome-devtools/remote-debugging [macOS notarization]: https://firefox-source-docs.mozilla.org/testing/geckodriver/Notarization.html +[Rust]: https://rustup.rs/ [`CloseWindowResponse`]: https://docs.rs/webdriver/newest/webdriver/response/struct.CloseWindowResponse.html [`CookieResponse`]: https://docs.rs/webdriver/newest/webdriver/response/struct.CookieResponse.html @@ -1629,6 +1613,7 @@ and greater. [Actions]: https://w3c.github.io/webdriver/webdriver-spec.html#actions [Delete Session]: https://w3c.github.io/webdriver/webdriver-spec.html#delete-session [Element Click]: https://w3c.github.io/webdriver/webdriver-spec.html#element-click +[Get Element Shadow Root]: https://w3c.github.io/webdriver/#get-element-shadow-root [Get Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#get-timeouts [Get Window Rect]: https://w3c.github.io/webdriver/webdriver-spec.html#get-window-rect [insecure certificate]: https://w3c.github.io/webdriver/webdriver-spec.html#dfn-insecure-certificate @@ -1644,6 +1629,7 @@ and greater. [WebDriver errors]: https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors [Bastien Orivel]: https://github.com/Eijebong +[David Burns]: https://github.com/AutomatedTester [Jason Juang]: https://github.com/juangj [Jeremy Lempereur]: https://github.com/o0Ignition0o [Joshua Bruning]: https://github.com/joshbruning |