Skip to content

@andreastt andreastt released this Sep 10, 2019

Built from bdb64cf16b68.

Added

  • Added support for HTTP HEAD requests to the HTTPD

    geckodriver now responds correctly to HTTP HEAD requests,
    which can be used for probing whether it supports a particular API.

    Thanks to Bastien Orivel for this patch.

  • Added support for searching for Nightly’s default path on macOS

    If the location of the Firefox binary is not given, geckodriver
    will from now also look for the location of Firefox Nightly in
    the default locations. The ordered list of search paths on macOS
    is as follows:

    1. /Applications/Firefox.app/Contents/MacOS/firefox-bin
    2. $HOME/Applications/Firefox.app/Contents/MacOS/firefox-bin
    3. /Applications/Firefox Nightly.app/Contents/MacOS/firefox-bin
    4. $HOME/Applications/Firefox Nightly.app/Contents/MacOS/firefox-bin

    Thanks to Kriti Singh for this patch.

  • Support for application bundle paths on macOS

    It is now possible to pass an application bundle path, such as
    /Applications/Firefox.app as argument to the binary field in
    moz:firefoxOptions. This will be automatically resolved to
    the absolute path of the binary when Firefox is started.

    Thanks to Nupur Baghel for this patch.

  • macOS and Windows builds are signed

    With this release of geckodriver, executables for macOS and Windows
    are signed using the same certificate key as Firefox. This should
    help in cases where geckodriver previously got misidentified as
    a virus by antivirus software.

Removed

  • Dropped support for legacy Selenium web element references

    The legacy way of serialising web elements, using {"ELEMENT": <UUID>},
    has been removed in this release. This may break older Selenium
    clients and clients which are otherwise not compatible with the
    WebDriver standard.

    Thanks to Shivam Singhal for this patch.

  • Removed --webdriver-port command-line option

    --webdriver-port <PORT> was an undocumented alias for --port,
    initially used for backwards compatibility with clients
    prior to Selenium 3.0.0.

Changed

  • Refactored Marionette serialisation

    Much of geckodriver’s internal plumbing for serialising WebDriver
    requests to Marionette messages has been refactored to decrease
    the amount of manual lifting.

    This work should have no visible side-effects for users.

    Thanks to Nupur Baghel for working on this throughout her
    Outreachy internship at Mozilla.

  • Improved error messages for incorrect command-line usage

Fixed

  • Errors related to incorrect command-line usage no longer hidden

    By mistake, earlier versions of geckodriver failed to print incorrect
    flag use. With this release problems are again written to stderr.

  • Search system path for Firefox binary on BSDs

    geckodriver would previously only search the system path for the
    firefox binary on Linux. Now it supports different BSD flavours
    as well.

Assets 7

@AutomatedTester AutomatedTester released this Jan 28, 2019

Built from 917474f3473e.

Added

  • Introduces strictFileInteractability capability

    The new capabilitiy indicates if strict interactability checks
    should be applied to <input type=file> elements. As strict
    interactability checks are off by default, there is a change
    in behaviour when using Element Send Keys
    with hidden file upload controls.

  • Added new endpoint GET /session/{session id}/moz/screenshot/full
    for taking full document screenshots, thanks to Greg Fraley.

  • Added new --marionette-host <HOSTNAME> flag for binding to a
    particular interface/IP layer on the system.

  • Added new endpoint POST /session/{session_id}/window/new
    for the New Window command to create a new top-level browsing context,
    which can be either a window or a tab. This feature requires
    Firefox 66 or later.

  • When using the preference devtools.console.stdout.content set to
    true logging of console API calls like info(), warn(), and
    error() can be routed to stdout.

  • geckodriver now sets the app.update.disabledForTesting preference
    to prevent Firefox >= 65 from automatically updating whilst under
    automation.

Removed

  • Turned off builds for arm7hf, which will no longer be released but
    can still be built from the source.

Changed

  • Allow file uploads to hidden <input type=file> elements

    Through a series of changes to the WebDriver specification,
    geckodriver is now aligned with chromedriver’s behaviour that
    allows interaction with hidden <input type=file> elements.

    This allows WebDriver to be used with various popular web
    frameworks that—through indirection—hides the file upload control
    and invokes it through other means.

  • Allow use of an indefinite script timeout for the Set Timeouts
    command, thanks to reimu.

Fixed

  • Corrected Content-Type of response header to utf-8 to fix
    an HTTP/1.1 compatibility bug.

  • Relaxed the deserialization of timeouts parameters to allow unknown
    fields for the Set Timeouts command.

  • Fixed a regression in the Take Element Screenshot to not screenshot
    the viewport, but the requested element.

Assets 7

@AutomatedTester AutomatedTester released this Jan 28, 2019 · 26 commits to master since this release

This release contains a number of fixes for regressions introduced
in 0.22.0, where we shipped a significant refactoring to the way
geckodriver internally dealt with JSON serialisation.

Removed

  • The POST /session/{session id}/element/{element id}/tap endpoint
    was removed, thanks to Kerem Kat.

Changed

Fixed

  • desiredCapabilities and requiredCapabilities are again
    recognised on session creation

    A regression in 0.22.0 caused geckodriver to recognise desired
    and required instead of the correct desiredCapabilities
    and requiredCapabilities. This will have caused significant
    problems for users who relied on this legacy Selenium-style
    session creation pattern.

    Do however note that support for Selenium-styled new session
    requests is temporary and that this will be removed sometime
    before the 1.0 release.

  • duration field made optional on pause actions

    A regression in 0.22.0 caused the pause action primitive to
    require a duration field. This has now been fixed so that
    pauses in action chains can be achieved with the default duration.

  • Log level formatted to expected Marionette input

    A regression in 0.22.0 caused the log level to be improperly
    formatted when using Firefox pre-releases. This is now fixed so
    that the requested log level is correctly interpreted by Marionette.

  • temporary field on addon installation made optional

    A regression in 0.22.0 caused the temporary field for POST
    /session/{session id}/moz/addon/install to be mandatory. This has
    now been fixed so that an addon is installed permanently by default.

  • SHA1s in version information uses limited number of characters

    The SHA1 used in --version when building geckodriver from a
    git repository is now limited to 12 characters, as it is when
    building from an hg checkout. This ensures reproducible builds.

Assets 8

@AutomatedTester AutomatedTester released this Sep 15, 2018 · 26 commits to master since this release

This release marks an important milestone on the path towards
a stable release of geckodriver. Large portions of geckodriver
and the [webdriver] library it is based on has been refactored to
accommodate using serde for JSON serialization.

We have also made great strides to improving WebDriver conformance,
to the extent that geckodriver is now almost entirely conforming
to the standard.

Added

  • Support for WebDriver web element-, web frame-, and web window
    identifiers from Firefox.

  • Added support for the non-configurable setWindowRect capability
    from WebDriver.

    This capability informs whether the attached browser supports
    manipulating the window dimensions and position.

  • A new extension capability moz:geckodriverVersion is returned
    upon session creation.

Changed

  • All JSON serialization and deserialisation has moved from
    rustc_serialize to serde.

  • The HTTP status codes used for script timeout and timeout
    errors has changed from Request Timeout (408) to Internal Server
    Error (500) in order to not break HTTP/1.1 Keep-Alive support,
    as HTTP clients interpret the old status code to mean they should
    duplicate the request.

  • The HTTP/1.1 Keep-Alive timeout for persistent connections has
    been increased to 90 seconds.

  • An invalid session ID error is now returned when there is no
    active session.

  • An invalid argument error is now returned when Add Cookie
    is given invalid parameters.

  • The handshake when geckodriver connects to Marionette has been
    hardened by killing the Firefox process if it fails.

  • The handshake read timeout has been reduced to 10 seconds instead
    of waiting forever.

  • The HTTP server geckodriver uses, hyper, has been upgraded to
    version 0.12, thanks to Bastien Orivel.

  • geckodriver version number is no longer logged on startup, as
    the log level is not configured until a session is created.

    The version number is available through --version, and now
    also through a new moz:geckodriverVersion field in the matched
    capabilities.

  • The webdriver library has been updated to version 0.37.0.

Fixed

Assets 8

@AutomatedTester AutomatedTester released this Jun 15, 2018 · 26 commits to master since this release

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 unhandledPromptBehavior capability now accepts accept and notify, dismiss and notify, and ignore options.

    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 -foreground and -no-remote
    flags if they have not already been specified by the user in
    moz:firefoxOptions.

    -foreground will ensure the application window gets focus when
    Firefox is started, and -no-remote will 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-Alive connections.

  • 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 localhost resolves 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.

Assets 8

@AutomatedTester AutomatedTester released this Apr 8, 2018 · 26 commits to master since this release

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.

Assets 8

@AutomatedTester AutomatedTester released this Mar 12, 2018 · 26 commits to master since this release

Added

  • New --jsdebugger flag to open the Browser Toolbox when Firefox
    launches. This is useful for debugging Marionette internals.

  • Introduced the temporary, boolean capability
    moz:useNonSpecCompliantPointerOrigin to disable the WebDriver
    conforming behavior of calculating the Pointer Origin.

Changed

  • HTTP status code for the StaleElementReference error 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 value field of the keyDown and keyUp action
    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.

Assets 8

@AutomatedTester AutomatedTester released this Oct 31, 2017 · 26 commits to master since this release

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 socksUsername and socksPassword proxy
    configuration keys because neither were picked up or recognised
Assets 8

@AutomatedTester AutomatedTester released this Sep 16, 2017 · 26 commits to master since this release

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

  • Log all used application arguments and not only -marionette

  • Early abort connection attempts to Marionette if the Firefox process
    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 ":"

  • The proxyType noproxy has been replaced with direct in accordance
    with recent WebDriver specification changes

  • 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.31.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
Assets 8

@andreastt andreastt released this Jul 11, 2017 · 26 commits to master since this release

Changed

  • RectResponse permits returning floats for width and height fields
  • 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
  • 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 SetTimeouts command maps to the Marionette setTimeouts command, which makes geckodriver compatible with Firefox 56 and greater
  • Linux x86 (i686-unknown-linux-musl) builds are fixed
Assets 8
You can’t perform that action at this time.