Repository navigation
Releases
v0.21.0
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)
Added
-
Support for the chrome element identifier from Firefox.
-
The
unhandledPromptBehaviorcapability now acceptsaccept and notify,dismiss and notify, andignoreoptions.Note that the unhandled prompt handler is not fully supported in
Firefox at the time of writing.
Changed
-
Firefox will now be started with the
-foregroundand-no-remote
flags if they have not already been specified by the user in
moz:firefoxOptions.-foregroundwill ensure the application window gets focus when
Firefox is started, and-no-remotewill prevent remote commands
to this instance of Firefox and also ensure we always start a new
instance. -
WebDriver commands that do not have a return value now correctly
return{value: null}instead of an empty dictionary. -
The HTTP server now accepts
Keep-Aliveconnections. -
Firefox remote protocol command mappings updated.
All Marionette commands changed to make use of the
WebDriver:
prefixes introduced with Firefox 56. -
Overhaul of Firefox preferences.
Already deprecated preferences in Firefox versions earlier than
57 got removed. -
webdriver crate upgraded to 0.36.0.
Fixed
-
Force use of IPv4 network stack.
On certain system configurations, where
localhostresolves to
an IPv6 address, geckodriver would attempt to connect to Firefox
on the wrong IP stack, causing the connection attempt to time out
after 60 seconds. We now ensure that geckodriver uses IPv4
consistently to both connect to Firefox and for allocating a free
port. -
geckodriver failed to locate the correct Firefox binary if it was
found under a firefox or firefox-bin directory, depending on
the system, because it thought the parent directory was the
executable. -
On Unix systems (macOS, Linux), geckodriver falsely reported
non-executable files as valid binaries. -
When stdout and stderr is redirected by geckodriver, a bug prevented
the redirections from taking effect.
v0.20.1
Fixed
-
Avoid attempting to kill Firefox process that has stopped.
With the change to allow Firefox enough time to shut down in
0.20.0, geckodriver started unconditionally killing the process
to reap its exit status. This caused geckodriver to inaccurately
report a successful Firefox shutdown as a failure.The regression should not have caused any functional problems, but
the termination cause and the exit status are now reported correctly.
v0.20.0
Added
-
New
--jsdebuggerflag to open the Browser Toolbox when Firefox
launches. This is useful for debugging Marionette internals. -
Introduced the temporary, boolean capability
moz:useNonSpecCompliantPointerOriginto disable the WebDriver
conforming behavior of calculating the Pointer Origin.
Changed
-
HTTP status code for the
StaleElementReferenceerror changed
from 400 (Bad Request) to 404 (Not Found). -
Backtraces from geckodriver no longer substitute for missing
Marionette stacktraces. -
webdriver crate upgraded to 0.35.0.
Fixed
-
The Firefox process is now given ample time to shut down, allowing
enough time for the Firefox shutdown hang monitor to kick in.Firefox has an integrated background monitor that observes
long-running threads during shutdown. These threads will be
killed after 63 seconds in the event of a hang. To allow Firefox
to shut down these threads on its own, geckodriver has to wait
that time and some additional seconds. -
Grapheme clusters are now accepted as input for keyboard input
to actions.Input to the
valuefield of thekeyDownandkeyUpaction
primitives used to only accept single characters, which means
geckodriver would error when a valid grapheme cluster was sent in,
for example with the tamil nadu character U+0BA8 U+0BBF.Thanks to Greg Fraley for fixing this bug.
-
Improved error messages for malformed capability values.
v0.19.1
Changed
-
Search suggestions in the location bar turned off as not to
trigger network connections -
Block addons incompatible with E10s
Fixed
-
Marionette stacktraces are now correctly propagated
-
Some error messages have been clarified
Removed
- Removed obsolete
socksUsernameandsocksPasswordproxy
configuration keys because neither were picked up or recognised
v0.19.0
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/minimizefor the Minimize Window
command
- POST
-
Added preference
extensions.shield-recipe-client.api_urlto disable shield
studies which could unexpectedly change the behavior of Firefox -
Introduced the temporary, boolean capability
moz:webdriverClickto 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.createInChildset to true to allow file
object creation in content processes
Changed
-
Log all used application arguments and not only
-marionette -
Early abort connection attempts to Marionette if the Firefox process
closed unexpectetly -
Removed deprecated
socksProxyVersionin favor ofsocksVersion -
Removed
ftpProxyPort,httpProxyPort,sslProxyPort, and
socksProxyPortbecause ports have to be set forftpProxy,
httpProxy,sslProxy, andsocksProxyusing ":" -
The
proxyTypenoproxyhas been replaced withdirectin accordance
with recent WebDriver specification changes -
The
WindowRectParametershave 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
FullscreenWindowto 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/installcommand accepts anaddonparameter, in lieu of
path, containing an addon as a Base64 string (fixed by Jason Juang) -
webdriver crate upgraded to version 0.31.0
-
mozrunner crate upgraded to version 0.5.0
Removed
- Removed the following obsolete preferences for Firefox:
browser.safebrowsing.enabledbrowser.safebrowsing.forbiddenURIs.enabledmarionette.defaultPrefs.portmarionette.logging
v0.18.0
Changed
RectResponsepermits returning floats forwidthandheightfields- New type
CookieResponsefor theGetNamedCookiecommand 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 theargsarray onmoz:firefoxOptions - geckodriver now recommends Firefox 53 and greater
- Version information (
--version) contains the hash from from the commit used to build geckodriver - geckodriver version logged on startup
- webdriver crate upgraded to version 0.27.0
- mozrunner crate upgraded to version 0.4.1
Fixed
- The
SetTimeoutscommand maps to the MarionettesetTimeoutscommand, which makes geckodriver compatible with Firefox 56 and greater - Linux x86 (i686-unknown-linux-musl) builds are fixed
v0.17.0
Added
- Added endpoints:
- POST
/session/{session id}/window/fullscreento invoke the window manager-specificfull screenoperation - POST
/session/{session id}/moz/addon/installto install an extension [Gecko only] - POST
/session/{session id}/moz/addon/uninstallto uninstall an extension [Gecko only]
- POST
Changed
- Increasing the length of the
network.http.phishy-userpass-lengthpreference will cause Firefox to not prompt when navigating to a website with a username or password in the URL - Library dependencies upgraded to mozrunner 0.4 and mozprofile 0.3 to allow overriding of preferences via capabilities if those have been already set in the profile
- Library dependencies upgraded to mozversion 0.1.2 to only use the normalized path of the Firefox binary for version checks but not to actually start the browser, which broke several components in Firefox on Windows
Fixed
- The SetWindowRect command now returns the WindowRect when it is done
- Use ASCII versions of array symbols to properly display them in the Windows command prompt
- Use
SessionNotCreatederror instead ofUnknownErrorif there is no current session
v0.16.1
Fixed
- Read Firefox version number from stdout when failing to look for the application .ini file (fixes Selenium #3884)
- Session is now ended when closing the last Firefox window (fixes #613)
v0.16.0
Note that geckodriver v0.16.0 is only compatible with Selenium 3.4 and greater.
Added
- Support for WebDriver-conforming New Session negotiation, with
desiredCapabilities/requiredCapabilitiesnegotiation as fallback - Added two new endpoints:
- GET
/session/{session id}/window/rectfor Get Window Rect - POST
/session/{session id}/window/rectfor Set Window Rect
- GET
- Align errors with the WebDriver errors:
- Introduces new errors
ElementClickIntercepted,ElementNotInteractable,InvalidCoordinates,NoSuchCookie,UnableToCaptureScreen, andUnknownCommand - Removes
ElementNotVisibleandInvalidElementCoordinateserrors
- Introduces new errors
Removed
- Removed following list of unused endpoints:
- GET
/session/{session id}/alert_text - POST
/session/{session id}/alert_text - POST
/session/{session id}/accept_alert - POST
/session/{session id}/dismiss_alert - GET
/session/{session id}/window_handle - DELETE
/session/{session id}/window_handle - POST
/session/{session id}/execute_async - POST
/session/{session id}/execute
- GET
Changed
SendKeysParameters, which is used for the Element Send Keys and Send Alert Text commands, has been updated to take a stringtextfieldCookieResponseandCloseWindowResponsefixed to be properly wrapped in avaluefield, like other responses- Allow negative numbers for
xandyfields inpointerMoveaction - Disable Flash and the plugin container in Firefox by default, which should help mitigate the “Plugin Container for Firefox has stopped wroking” problems many users were reporting when deleting a session
- Preferences passed in a profile now take precedence over set of default preferences defined by geckodriver (fixed by @DrMarcII)
- The exceptions are the
marionette.portandmarionette.log.levelpreferences and their fallbacks, which are set unconditionally and cannot be overriden
- The exceptions are the
- Remove default preference that disables unsafe CPOW checks
- WebDriver library updated to 0.25.2
Fixed
- Fix for the “corrupt deflate stream” exception that sometimes occured when trying to write an empty profile by @kirhgoph
- Recognise
sslProxyandsslProxyPortentries in the proxy configuration object (fixed by @juangj) - Fix “
httpProxyPortwas not an integer” error (fixed by @juangj) - Fix broken unmarshaling of Get Timeouts response format from Firefox 52 and earlier (fixed by @juangj)
- Allow preferences in
moz:firefoxOptionsto be both positive- and negative integers (fixed by @juangj) - Allow IPv6 hostnames in the proxy configuration object
- i686-unknown-linux-musl (Linux 32-bit) build fixed
- Log messages from other Rust modules are now ignored
- Improved log messages to the HTTPD
v0.15.0
IMPORTANT: If you use geckodriver with Selenium, you must upgrade to Selenium 3.3 since this release aligns HTTP responses with the WebDriver standard.
Added
- Added routing and parsing for the Get Timeouts command
Changed
- All HTTP responses are now wrapped in
{value: …}objects per the WebDriver specification; this may likely require you to update your client library - Pointer move action’s
elementkey changed toorigin, which lets pointer actions originate within the context of the viewport, the pointer’s current position, or from an element - Now uses about:blank as the new tab document; this was previously disabled due to bug 1333736 in Marionette
- WebDriver libary updated to 0.23.0
Fixed
- Aligned the data structure accepted by the Set Timeouts command with the WebDriver specification