Bug 1391605 - Update CHANGES.md for changes in geckodriver 0.19.0. draft
authorHenrik Skupin <mail@hskupin.info>
Thu, 14 Sep 2017 18:06:43 +0200
changeset 665481 7dfddadf8ceb324bb238aede26b141e42dc089e3
parent 664736 dd6b788f149763c4014c27f2fe1a1d13228bda82
child 665482 ae4f5ea96ce501d03b03e2a39efca20ad3eb09bf
push id80080
push userbmo:hskupin@gmail.com
push dateFri, 15 Sep 2017 15:14:56 +0000
bugs1391605
milestone57.0a1
Bug 1391605 - Update CHANGES.md for changes in geckodriver 0.19.0. MozReview-Commit-ID: D1AAN8iWsuP
testing/geckodriver/CHANGES.md
testing/geckodriver/README.md
--- 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