Bug 1391605 - Update CHANGES.md for changes in geckodriver 0.19.0.
MozReview-Commit-ID: D1AAN8iWsuP
--- a/testing/geckodriver/CHANGES.md
+++ b/testing/geckodriver/CHANGES.md
@@ -1,19 +1,33 @@
Change log
==========
All notable changes to this program is documented in this file.
-Unreleased
-----------
+0.19.0 (2017-09-16)
+-------------------
+
+Note that with geckodriver v0.19.0 the following versions are recommended:
+- Firefox 55.0 (and greater)
+- Selenium 3.5 (and greater)
### Added
+- Added endpoint:
+ - POST `/session/{session id}/window/minimize` for the [Minimize Window]
+ command
+
+- Added preference `extensions.shield-recipe-client.api_url` to disable shield
+ studies which could unexpectedly change the behavior of Firefox
+
+- Introduced the temporary, boolean capability `moz:webdriverClick` to enable
+ the WebDriver conforming behavior of the [Element Click] command.
+
- Added crashreporter environment variables to better control the browser
in case of crashes
- Added preference `dom.file.createInChild` set to true to allow file
object creation in content processes
### Changed
@@ -23,43 +37,53 @@ Unreleased
closed unexpectetly
- Removed deprecated `socksProxyVersion` in favor of `socksVersion`
- Removed `ftpProxyPort`, `httpProxyPort`, `sslProxyPort`, and
`socksProxyPort` because _ports_ have to be set for `ftpProxy`,
`httpProxy`, `sslProxy`, and `socksProxy` using ":<PORT>"
-- To make sure no browser process is left behind when the [`NewSession`]
- fails, the process is closed immediately now
-
- The `proxyType` `noproxy` has been replaced with `direct` in accordance
with recent WebDriver specification changes
-- `/moz/addon/install` command accepts an `addon` parameter, in lieu of
- `path`, containing an addon as a Base64 string
-
- The [`WindowRectParameters`] have been updated to return signed 32-bit
integers in accordance with the CSS and WebDriver specifications, and
to be more liberal with the input types
+- Mapped the [`FullscreenWindow`] to the correct Marionette command
+
+- To make sure no browser process is left behind when the [`NewSession`]
+ fails, the process is closed immediately now
+
+- `/moz/addon/install` command accepts an `addon` parameter, in lieu of
+ `path`, containing an addon as a Base64 string (fixed by [Jason Juang])
+
- [webdriver crate] upgraded to version 0.30.0
- [mozrunner crate] upgraded to version 0.5.0
+### Removed
+
+- Removed the following obsolete preferences for Firefox:
+ - `browser.safebrowsing.enabled`
+ - `browser.safebrowsing.forbiddenURIs.enabled`
+ - `marionette.defaultPrefs.port`
+ - `marionette.logging`
+
0.18.0 (2017-07-10)
-------------------
### Changed
- [`RectResponse`] permits returning floats for `width` and `height`
fields
-- New type [`CookieResponse`] for the [`GetNamedCookie` command] returns
+- New type [`CookieResponse`] for the [`GetNamedCookie`] command returns
a single cookie, as opposed to an array of a single cookie
- To pick up a prepared profile from the filesystem, it is now possible
to pass `["-profile", "/path/to/profile"]` in the `args` array on
`moz:firefoxOptions`
- geckodriver now recommends Firefox 53 and greater
@@ -740,22 +764,24 @@ 0.1.0 (2015-04-09)
[`UnknownCommand`]: https://docs.rs/webdriver/newest/webdriver/error/enum.ErrorStatus.html#variant.UnknownCommand
[`UnknownError`]: https://docs.rs/webdriver/newest/webdriver/error/enum.ErrorStatus.html#variant.UnknownError
[`WindowRectParameters`]: https://docs.rs/webdriver/newest/webdriver/command/struct.WindowRectParameters.html
[mozrunner crate]: https://crates.io/crates/mozrunner
[webdriver crate]: https://crates.io/crates/webdriver
[Actions]: https://w3c.github.io/webdriver/webdriver-spec.html#actions
-[Get Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#dfn-get-timeouts
-[Get Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#set-timeouts
+[Element Click]: https://w3c.github.io/webdriver/webdriver-spec.html#element-click
+[Get Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#get-timeouts
+[Set Timeouts]: https://w3c.github.io/webdriver/webdriver-spec.html#set-timeouts
[Get Window Rect]: https://w3c.github.io/webdriver/webdriver-spec.html#get-window-rect
-[Get Window Rect]: https://w3c.github.io/webdriver/webdriver-spec.html#set-window-rect
+[Set Window Rect]: https://w3c.github.io/webdriver/webdriver-spec.html#set-window-rect
[insecure certificate]: https://w3c.github.io/webdriver/webdriver-spec.html#dfn-insecure-certificate
-[New Session]: https://w3c.github.io/webdriver/webdriver-spec.html#dfn-new-session
+[Minimize Window]: https://w3c.github.io/webdriver/webdriver-spec.html#minimize-window
+[New Session]: https://w3c.github.io/webdriver/webdriver-spec.html#new-session
[Send Alert Text]: https://w3c.github.io/webdriver/webdriver-spec.html#send-alert-text
[Status]: https://w3c.github.io/webdriver/webdriver-spec.html#status
[Take Element Screenshot]: https://w3c.github.io/webdriver/webdriver-spec.html#take-element-screenshot
[WebDriver errors]: https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors
[Jason Juang]: https://github.com/juangj
[Joshua Bruning]: https://github.com/joshbruning
[Kalpesh Krishna]: https://github.com/martiansideofthemoon
--- a/testing/geckodriver/README.md
+++ b/testing/geckodriver/README.md
@@ -46,17 +46,17 @@ Supported Firefoxen
geckodriver is not yet feature complete. This means that it does not
yet offer full conformance with the [WebDriver] standard or complete
compatibility with [Selenium]. You can track the [implementation
status] of the latest [Firefox Nightly](http://whattrainisitnow.com/)
on [MDN]. We also keep track of known [Selenium], [remote protocol],
and [specification] problems in our [issue tracker].
-Support is best in Firefox 53 and greater, although generally the more
+Support is best in Firefox 55 and greater, although generally the more
recent the Firefox version, the better the experience as they have more
bug fixes and features. Some features will only be available in the
most recent Firefox versions, and we strongly advise using the latest
[Firefox Nightly] with geckodriver. Since Windows XP support in Firefox
was dropped with Firefox 53, we do not support this platform.
[implementation status]: https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette/WebDriver/status
[MDN]: https://developer.mozilla.org/
@@ -365,17 +365,17 @@ Usage steps are [documented on
MDN](https://developer.mozilla.org/en-US/docs/Mozilla/QA/Marionette/WebDriver),
but how you invoke geckodriver largely depends on your use case.
Selenium
--------
If you are using geckodriver through [Selenium], you must ensure that
-you have version 3.4 and greater. Because geckodriver implements the
+you have version 3.5 and greater. Because geckodriver implements the
[W3C WebDriver standard][WebDriver] and not the same Selenium wire
protocol older drivers are using, you may experience incompatibilities
and migration problems when making the switch from FirefoxDriver to
geckodriver.
Generally speaking, Selenium 3 enabled geckodriver as the default
WebDriver implementation for Firefox. With the release of Firefox 47,
FirefoxDriver had to be discontinued for its lack of support for the