RubyGems - selenium-webdriver - Versions diffs - 4.0.0.alpha5 → 4.0.0.beta3 - Mend

selenium-webdriver 4.0.0.alpha5 → 4.0.0.beta3

Files changed (87) hide show

checksums.yaml +4 -4
data/lib/selenium/devtools.rb +30 -0
data/lib/selenium/server.rb +18 -26
data/lib/selenium/webdriver.rb +1 -3
data/lib/selenium/webdriver/atoms/findElements.js +93 -93
data/lib/selenium/webdriver/atoms/getAttribute.js +75 -59
data/lib/selenium/webdriver/atoms/isDisplayed.js +72 -72
data/lib/selenium/webdriver/atoms/mutationListener.js +55 -0
data/lib/selenium/webdriver/chrome.rb +1 -1
data/lib/selenium/webdriver/chrome/driver.rb +28 -6
data/lib/selenium/webdriver/chrome/{bridge.rb → features.rb} +6 -8
data/lib/selenium/webdriver/chrome/options.rb +54 -37
data/lib/selenium/webdriver/chrome/profile.rb +6 -3
data/lib/selenium/webdriver/chrome/service.rb +4 -2
data/lib/selenium/webdriver/common.rb +7 -2
data/lib/selenium/webdriver/common/driver.rb +86 -26
data/lib/selenium/webdriver/common/driver_extensions/has_authentication.rb +89 -0
data/lib/selenium/webdriver/common/driver_extensions/has_devtools.rb +6 -1
data/lib/selenium/webdriver/common/driver_extensions/has_location.rb +5 -8
data/lib/selenium/webdriver/common/driver_extensions/has_log_events.rb +149 -0
data/lib/selenium/webdriver/{edge_chrome/bridge.rb → common/driver_extensions/has_logs.rb} +7 -7
data/lib/selenium/webdriver/common/driver_extensions/has_network_connection.rb +6 -27
data/lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb +67 -0
data/lib/selenium/webdriver/common/driver_extensions/has_remote_status.rb +1 -0
data/lib/selenium/webdriver/common/driver_extensions/{rotatable.rb → prints_page.rb} +18 -20
data/lib/selenium/webdriver/common/element.rb +66 -12
data/lib/selenium/webdriver/common/interactions/interaction.rb +4 -1
data/lib/selenium/webdriver/common/logger.rb +6 -3
data/lib/selenium/webdriver/common/manager.rb +11 -1
data/lib/selenium/webdriver/common/options.rb +90 -11
data/lib/selenium/webdriver/common/platform.rb +3 -1
data/lib/selenium/webdriver/common/port_prober.rb +4 -6
data/lib/selenium/webdriver/common/proxy.rb +4 -1
data/lib/selenium/webdriver/common/search_context.rb +4 -1
data/lib/selenium/webdriver/common/service.rb +13 -114
data/lib/selenium/webdriver/common/service_manager.rb +151 -0
data/lib/selenium/webdriver/common/socket_poller.rb +19 -30
data/lib/selenium/webdriver/common/takes_screenshot.rb +63 -0
data/lib/selenium/webdriver/common/target_locator.rb +4 -4
data/lib/selenium/webdriver/devtools.rb +144 -0
data/lib/selenium/webdriver/devtools/console_event.rb +38 -0
data/lib/selenium/webdriver/{edge_html/driver.rb → devtools/exception_event.rb} +10 -13
data/lib/selenium/webdriver/devtools/mutation_event.rb +37 -0
data/lib/selenium/webdriver/devtools/request.rb +57 -0
data/lib/selenium/webdriver/edge.rb +7 -29
data/lib/selenium/webdriver/{edge_chrome → edge}/driver.rb +10 -4
data/lib/selenium/webdriver/edge/features.rb +39 -0
data/lib/selenium/webdriver/{edge_chrome → edge}/options.rb +12 -3
data/lib/selenium/webdriver/{edge_chrome → edge}/profile.rb +2 -2
data/lib/selenium/webdriver/{edge_chrome → edge}/service.rb +2 -2
data/lib/selenium/webdriver/firefox.rb +5 -1
data/lib/selenium/webdriver/firefox/driver.rb +19 -3
data/lib/selenium/webdriver/firefox/{bridge.rb → features.rb} +3 -3
data/lib/selenium/webdriver/firefox/options.rb +25 -31
data/lib/selenium/webdriver/firefox/profile.rb +12 -2
data/lib/selenium/webdriver/firefox/service.rb +1 -1
data/lib/selenium/webdriver/ie/driver.rb +1 -2
data/lib/selenium/webdriver/ie/options.rb +7 -20
data/lib/selenium/webdriver/ie/service.rb +4 -2
data/lib/selenium/webdriver/remote/bridge.rb +50 -42
data/lib/selenium/webdriver/remote/capabilities.rb +127 -71
data/lib/selenium/webdriver/remote/commands.rb +3 -0
data/lib/selenium/webdriver/remote/driver.rb +10 -3
data/lib/selenium/webdriver/remote/http/common.rb +0 -5
data/lib/selenium/webdriver/remote/http/default.rb +8 -7
data/lib/selenium/webdriver/remote/http/persistent.rb +6 -0
data/lib/selenium/webdriver/safari.rb +8 -1
data/lib/selenium/webdriver/safari/driver.rb +3 -4
data/lib/selenium/webdriver/safari/{bridge.rb → features.rb} +3 -3
data/lib/selenium/webdriver/safari/options.rb +1 -33
data/lib/selenium/webdriver/support/block_event_listener.rb +1 -1
data/lib/selenium/webdriver/support/color.rb +2 -2
data/lib/selenium/webdriver/support/event_firing_bridge.rb +1 -1
data/lib/selenium/webdriver/support/guards.rb +95 -0
data/lib/selenium/webdriver/support/guards/guard.rb +89 -0
data/lib/selenium/webdriver/support/guards/guard_condition.rb +52 -0
data/lib/selenium/webdriver/support/select.rb +2 -2
data/lib/selenium/webdriver/version.rb +1 -1
metadata +69 -32
data/CHANGES +0 -1725
data/Gemfile +0 -4
data/LICENSE +0 -202
data/README.md +0 -35
data/lib/selenium/webdriver/common/driver_extensions/takes_screenshot.rb +0 -65
data/lib/selenium/webdriver/edge_html/options.rb +0 -91
data/lib/selenium/webdriver/edge_html/service.rb +0 -47
data/selenium-webdriver.gemspec +0 -48

data/CHANGES DELETED Viewed

@@ -1,1725 +0,0 @@
-4.0.0.alpha5 (2020-03-18)
-=========================
-The release is just to synchronize version with other bindings and does not
-include any changes.
-4.0.0.alpha4 (2020-01-09)
-=========================
-Ruby:
-  * Added initial support for relative locators, which allow to find elements
-    above/below/left/right/near another element. For example, you can find all
-    the cells in a table to the right of your starting cell:
-      start_cell = driver.find_element(css: 'td')
-      right_cells = driver.find_elements(relative: {tag_name: 'td', right: start_cell})
-    The documentation is still lacking so refer to examples in df6be2e962.
-  * Added ability to silence certain logger messages by using it's identifiers:
-      Selenium::WebDriver.logger.ignore(:driver_path)
-  * Added new dependency: websocket. It's used for communicating with Chrome DevTools.
-  * Loosened childprocess dependency to allow using version 2.0+.
-  * Loosened rubyzip dependency to allow using version 2.0+.
-  * Fixed Errno::EACCES error on Linux DeX and similar distributes
-Chrome:
-  * Added initial support for communicating with Chrome DevTools. The implementation
-    is very basic and lacks CDP domains, events and types - those will be added
-    in future releases. Still, it allows to execute simple commands to DevTools:
-      driver.devtools.send('Page.navigate', {url: 'https://google.com'})
-4.0.0.alpha3 (2019-07-08)
-=========================
-Ruby:
-  * All documented driver capabilities supported in respective browser Options class by constructor and accessor
-  * Driver constructor :options and :desired_capabilities generate the same capabilities for local and remote execution
-  * Deprecated :options as keyword for initializing browser Options classes
-Chrome:
-  * Add support for browser logging with latest versions of chromedriver
-Edge:
-  * Add support for Chromium based implementation
-4.0.0.alpha2 (2019-05-02)
-=========================
-Ruby:
-  * Fixed an issue with previous alpha release which lead to removed files
-    being packaged inside the gem
-4.0.0.alpha1 (2019-05-01)
-=========================
-Ruby:
-  * Removed Mouse and Keyboard as their implementations are not compliant to WebDriver specification
-  * Removed TouchActionBuilder as its implementation is not compliant to WebDriver specification
-  * Change ActionBuilder to be fully compliant to WebDriver specification
-  * Change Manager to be fully compliant to WebDriver specification
-  * Removed all deprecated errors that are not compliant to WebDriver specification
-  * Update minimum required Ruby version to 2.4
-  * Changed capabilities to use only those that are compliant to WebDriver specification
-  * Removed deprecated timeout setter on default HTTP client
-  * Removed deprecated Remote::W3C::Capabilities
-  * Fixed an issue when services are not shutdown properly
-Chrome:
-  * Removed support for OSS mode - use W3C mode instead by using
-    Selenium::WebDriver::Chrome::Options.new(options: {w3c: true})
-PhantomJS:
-  * Removed support for PhantomJS driver
-Firefox:
-  * Removed support for legacy Firefox driver - use GeckoDriver instead
-  * Removed deprecated outdated capabilities
-  * Fixed an issue when passing :profile string to Firefox::Options.new would
-    result in NoMethodError. Now it will find a profile with such name on your
-    system and use it accordingly (issue #7119)
-3.142.7 (2019-12-27)
-====================
-Ruby:
-  * Fix keyword argument deprecations in Ruby 2.7 (thanks @connorshea)
-3.142.6 (2019-10-04)
-====================
-Ruby:
-  * Loosen ChildProcess dependency so that 3.0+ can be used (thanks @jaredbeck)
-3.142.5 (2019-10-01)
-====================
-Ruby:
-  * Loosen RubyZip dependency so that 1.3+ can be used (thanks @vtamara)
-3.142.4 (2019-09-02)
-====================
-Chrome:
-  * Added support for new command for getting logs in ChromeDriver 76+
-    with W3C mode on
-3.142.3 (2019-05-21)
-====================
-Firefox:
-  * Fixed a regression when Firefox binary path was not sent to GeckoDriver
-    by default and browser could not be located (issue #7219)
-3.142.2 (2019-05-11)
-====================
-Chrome:
-  * Fixed an issue when getting/setting network conditions and sending CDP
-    commands didn't work with Grid (issue #7174)
-Safari:
-  * Fixed an issue when getting/setting permissions and attaching debugger
-    didn't work with Grid (issue #7174)
-3.142.1 (2019-05-07)
-====================
-Firefox:
-  * Fixed an issue when processing error in legacy driver would result
-    in NoMethodError (issue #7178)
-3.142.0 (2019-04-24)
-====================
-Ruby:
-  * Fixed an issue when services are not shutdown properly
-Firefox:
-  * Fixed an issue when passing :profile string to Firefox::Options.new would
-    result in NoMethodError. Now it will find a profile with such name on your
-    system and use it accordingly (issue #7119)
-  * Fixed an issue when instantiating Firefox driver with capabilities having
-    :marionette would result in NoMethodError (issue #7120)
-3.141.5926 (2019-04-18)
-=======================
-Ruby:
-  * Fixed an issue when Selenium itself would print deprecation warning
-    for TimeoutError
-  * Fixed a regression when socket poller would raise Errno::EBADF on JRuby
-3.141.592 (2019-04-18)
-======================
-Ruby:
-  * Updated minimum required Ruby version to 2.3
-  * Added support for ChildProcess 1.x
-  * Improved socket connection waiting (thanks @N0xFF)
-  * Changed waiting to use monotonic clock instead of Time class to avoid
-    collisions with Timecop and similar gems
-  * Removed deprecated PortProber.random
-  * Added strictFileInteractability to the list of known capabilities
-  * Added InsecureCertificateError
-  * Added support for setting SOCKS version in proxy (issue #6938)
-  * Implemented new window command using driver.manage.new_window. The command
-    is supported by recent Firefox, Safari and IE drivers (thanks @dylanlive)
-  * Added support for passing proc to driver_path setter in Service classes
-  * Deprecated all errors which don't exist in WebDriver specification
-  * Deprecated TouchActionBuilder which is not a part of WebDriver specification
-    and is only supported by Chrome, but is likely to be dropped in v75.
-    ActionBuilder should be used instead
-  * Deprecated using Remote::W3C::Capabilities in favor of Remote::Capabilities
-Chrome:
-  * Added support for execute CDP commands using Driver#execute_cdp
-  * Removed GPU disabling in ChromeDriver when using Options#headless!
-  * Switched suggested download URL to HTTPS (thanks @JLLeitschuh)
-  * Added support for instantiating service class directly and moved all driver
-    executable configuration there (command-line arguments, port, etc.)
-    Passing driver_opts, driver_path and port to driver initializer is now
-    deprecated so use Selenium::WebDriver::Service.chrome instead, which allows
-    to customize executable behavior in similar way. Once initialized, this
-    object can be passed as :service keyword during driver initialization.
-  * Deprecated Chrome.driver_path= in favor of Service::Chrome.driver_path=
-Edge:
-  * Added support for instantiating service class directly and moved all driver
-    executable configuration there (command-line arguments, port, etc.)
-    Passing driver_opts, driver_path and port to driver initializer is now
-    deprecated so use Selenium::WebDriver::Service.firefox instead, which allows
-    to customize executable behavior in similar way. Once initialized, this
-    object can be passed as :service keyword during driver initialization
-  * Deprecated Edge.driver_path= in favor of Service::Edge.driver_path=
-Firefox:
-  * Deprecated legacy driver in favor of GeckoDriver
-  * Fixed Firefox path lookup on Cygwin (issue #6908)
-  * Added support for instantiating service class directly and moved all driver
-    executable configuration there (command-line arguments, port, etc.)
-    Passing driver_opts, driver_path and port to driver initializer is now
-    deprecated so use Selenium::WebDriver::Service.firefox instead, which allows
-    to customize executable behavior in similar way. Once initialized, this
-    object can be passed as :service keyword during driver initialization
-  * Deprecated Firefox.driver_path= in favor of Service::Firefox.driver_path=
-  * Deprecated outdated capabilities
-IE:
-  * Fixed an issue when native events could not be disabled using IE::Options
-    initializer
-  * Added support for instantiating service class directly and moved all driver
-    executable configuration there (command-line arguments, port, etc.)
-    Passing driver_opts, driver_path and port to driver initializer is now
-    deprecated so use Selenium::WebDriver::Service.ie instead, which allows
-    to customize executable behavior in similar way. Once initialized, this
-    object can be passed as :service keyword during driver initialization
-  * Deprecated IE.driver_path= in favor of Service::IE.driver_path=
-Safari:
-  * Added support for instantiating service class directly and moved all driver
-    executable configuration there (command-line arguments, port, etc.)
-    Passing driver_opts, driver_path and port to driver initializer is now
-    deprecated so use Selenium::WebDriver::Service.safari instead, which allows
-    to customize executable behavior in similar way. Once initialized, this
-    object can be passed as :service keyword during driver initialization
-  * Deprecated Safari.driver_path= in favor of Service::Safari.driver_path=
-Remote:
-  * Change default HTTP client to use persistent connections
-3.141.0 (2018-10-31)
-====================
-Edge:
-  * Added new Edge::Options class that should be used to customize browser
-    behavior. The instance of options class can be passed to driver
-    initialization using :options key. Please, note that using options require
-    insiders builds of Edge.
-Chrome:
-  * Included HasLocation to Chrome driver (thanks @sidonath).
-  * Updated endpoint to send Chrome Debugging Protocol commands. The old one
-    has been deprecated in ChromeDriver 40.
-Safari:
-  * Added new Safari::Options class that should be used to customize browser
-    behavior. The instance of options class can be passed to driver
-    initialization using :options key. Please, note that using options require
-    Safari 12+.
-Remote:
-  * Allow passing Options instances to remote driver initialization using
-    :options key. This feature allows to use browser-specific options classes
-    (Chrome::Options, Firefox::Options, etc.) and pass them to Server/Grid
-    instead of capabilities.
-3.14.1 (2018-10-03)
-===================
-Ruby:
-  * Added a workaround to ignore Errno::EALREADY error when starting drivers
-    on Windows Subsystem for Linux
-  * Changed default pause duration to 0 for Selenium::WebDriver::Driver#action#pause (thanks @twalpole)
-  * Deprecated Selenium::WebDriver::PortProber#random
-    in favor of Selenium::WebDriver::PortProber#above
-  * Fixed a bug when Selenium::WebDriver::Element#drag_and_drop would not
-    work in certain cases
-  * Updated RubyZip dependency to 1.2.2 which fixes security vulnerability
-Edge:
-  * Added support for --silent driver flag
-  * Fixed an incorrect dash symbol when passing arguments to MicrosoftWebDriver.exe
-Firefox:
-  * Fixed an incorrect dash symbol when passing arguments to GeckoDriver
-Safari:
-  * Fixed a bug when Selenium::WebDriver::Element#displayed? would raise error
-    in Safari 12
-3.14.0 (2018-08-03)
-===================
-Ruby:
-  * Allow to customize default duration of movement of pointer actions using
-    Driver#action#default_move_duration= (thanks @prakharrr)
-  * Fixed an accidentally removed Selenium::WebDriver::Error::TimeoutError (thanks @twalpole)
-Server:
-  * Fixed an issue when Server.latest couldn't parse the version
-Remote:
-  * Added support for uploading multiple files by passing them as a string
-    separated by \n to Element#send_keys. Please, note that not all the drivers
-    have multiple file upload implemented (tested to work in ChromeDriver).
-3.13.1 (2018-07-20)
-===================
-Chrome:
-  * Fixed an issue when empty Chrome options would cause DevToolsActivePort issue (thanks @artplan1)
-Remote:
-  * Support detecting local files (thanks @mskvn)
-3.13.0 (2018-06-25)
-===================
-Ruby:
-  * Address warnings for redefined methods and uninitialized instance variables
-Chrome:
-  * Chrome options capabilities updated to use goog:chromeOptions.
-    Note that Selenium now requires ChromeDriver v2.31 at minimum.
-  * Added ability to tell headless Chrome to save files using Driver#download_path= (thanks @pelly)
-3.12.0 (2018-05-08)
-===================
-Ruby:
-  * Added User-Agent header to requests from Selenium to give remote
-    ends more visibility into distribution of clients (thanks @sah)
-  * Added Selenium::WebDriver::VERSION constant (thanks @sah)
-  * Added changelog link to RubyGems page
-  * Fixed a bug when requests were sent with empty Content-Type,
-    which should instead be application/json (issue #5615 and #5659)
-  * Fixed a bug when failed connection attempt was retried without
-    grace period for remote to resolve its problem (thanks @amckinley42)
-  * Fixed a bug with accidentally removed HasNetworkConnection driver extension
-Chrome:
-  * Fixed a bug when deprecation message for using Chrome extensions
-    was incorrectly shown (thanks @treby)
-Safari:
-  * Added support getting permissions via Driver#permissions
-  * Added support setting permissions via Driver#permissions=
-  * Added support enabling web inspector via Driver#attach_debugger
-3.11.0 (2018-03-11)
-===================
-Ruby:
-  * No changes in Ruby bindings for this release
-3.10.0 (2018-03-02)
-===================
-Ruby:
-  * Added Errno::EAFNOSUPPORT to the list of ignored errors when finding port (thanks @jtarchie)
-  * Added automatic conversion of noProxy to the list of strings as required
-    by W3C WebDriver Specification (issue #5004)
-Chrome:
-  * Added Chrome::Options#headless! shortcut to enable headless mode (thanks @pulkitsharma07)
-IE:
-  * Added support for getting local storage using Driver#local_storage
-  * Added support for getting session storage using Driver#session_storage
-3.9.0 (2018-02-06)
-==================
-Ruby:
-  * Fixed a bug when omitted capabilities caused NoMethodError (issue #5185)
-  * Fixed a bug when getting page source in W3C dialect caused WebDriverError (thanks @KazuCocoa)
-  * Fixed a bug when getting backtrace of server error would case NoMethodError (thanks @mcking49)
-  * Updated YARD to ~> 0.9.11
-  * Updated rubyzip to ~> 1.2 (thanks @michaelglass)
-Chrome:
-  * Added support for getting network conditions via Driver#network_conditions
-  * Added support for setting network conditions via Driver#network_conditions=
-  * Added support to allow driver respond with custom error codes (issue #5376)
-Firefox:
-  * Improved GeckoDriver binary lookup mechanism (issue #5240)
-3.8.0 (2017-12-01)
-==================
-Ruby:
-  * Removed deprecated Alert#authenticate
-  * Removed deprecated :port initialization argument of Remote::Bridge.
-    Use :url instead.
-  * Removed deprecated Selenium::WebDriver::Remote::W3CCapabilities.
-    Use Selenium::WebDriver::Remote::Capabilities instead.
-IE:
-  * Remove deprecated :log_file driver initialization argument.
-    Use driver_opts: {log_file: ''} instead.
-  * Remove deprecated :log_level driver initialization argument.
-    Use driver_opts: {log_level: ''} instead.
-  * Remove deprecated :implementation driver initialization argument.
-    Use driver_opts: {implementation: ''} instead.
-  * Removed deprecated :service_args driver initialization argument.
-    Use driver_opts: {args: ['--some-switch']} instead.
-Chrome:
-  * Removed deprecated :service_log_path driver initialization argument.
-    Use driver_opts: {log_path: 'path'} instead.
-  * Removed deprecated :service_args driver initialization argument.
-    Use driver_opts: {args: ['--some-switch']} instead.
-Firefox:
-  * Removed deprecated :service_args driver initialization argument.
-    Use driver_opts: {args: ['--some-switch']} instead.
-Safari:
-  * Removed deprecated :service_args driver initialization argument.
-    Use driver_opts: {args: ['--some-switch']} instead.
-Edge:
-  * Removed deprecated :service_args driver initialization argument.
-    Use driver_opts: {args: ['--some-switch']} instead.
-3.7.0 (2017-11-03)
-==================
-Ruby:
-  * Added //rb:lint task to check codebase using RuboCop (thanks @RustyNail)
-  * Fixed codebase to comply more to Ruby community style guide (thanks @RustyNail)
-  * Packaged all dependencies to Selenium repository so that non-Ruby committers
-    can build and test Ruby bindings easier
-  * Update errors list according to latest changes of specification (thanks @jaysonesmith)
-Firefox:
-  * Added Firefox::Options#headless! shortcut to enable headless mode (thanks @franzliedke)
-3.6.0 (2017-09-25)
-==================
-Edge:
-  * Fixed a bug when execute_script failed using server + Edge (issue #4651)
-Firefox:
-  * Fixed a bug when web extension failed to install using profile class (issue #4093)
-PhantomJS:
-  * Support is deprecated in favor of headless Chrome/Firefox or HTMLUnit.
-    PhantomJS is no longer actively developed, and support will eventually
-    be dropped.
-3.5.2 (2017-09-07)
-==================
-Ruby:
-  * Removed platformVersion from W3C payload (issue #4641)
-  * Fixed a bug when proxy type was not compliant to specification (issue #4574)
-  * Added support for passing speed to flick action (issue #4549)
-  * Using TouchActionBuilder no longer prints mouse/key deprecations
-  * Deprecated Alert#authenticate
-  * Added support for DEBUG environment variable which enables full debug mode in gem
-Firefox:
-  * Fixed a bug when page load timeout was not properly constructed in new session payload
-  * Fixed a bug when GeckoDriver error stacktrace was not displayed (issue #3683)
-Chrome:
-  * Added workaround for the case when findElements call returns null (issue #4555)
-  * Chrome::Driver now includes touch actions by default
-3.5.1 (2017-08-15)
-==================
-Ruby:
-  * Fixed a bug when Chrome/Firefox (and probably other) drivers could not be
-    started on JRuby (issue #4453).
-3.5.0 (2017-08-10)
-==================
-Firefox:
-  * Firefox subprocess output is now only redirected when debug is set (issue #4311)
-  * Fixed a bug where non-integers could be sent when setting window rect
-  * Fixed Firefox location detection on Windows_x64 (thanks kamenlitchev)
-  * Fixed passing of profile with a W3C compatible remote end
-IE:
-  * Added new IE::Options class that should be used to customize browser
-    behavior (native events, element scroll behavior, etc).
-    The instance of options class can be passed to driver initialization using
-    :options key. Old way of passing these customization directly to driver
-    initialization is deprecated.
-3.4.4 (2017-07-13)
-==================
-Firefox:
-  * Added support for GeckoDriver install addon command (issue 4215).
-  * Added support for GeckoDriver uninstall addon command (issue 4215).
-  * Raise error when passing :firefox_options as capability.
-Ruby:
-  * Fixed a bug when childprocess were leaking /dev/null file descriptor (issue 4285).
-  * Make Remote::Driver class so that it can be inherited from.
-3.4.3 (2017-06-16)
-==================
-Ruby:
-  * Fixed a regression when passing symbol as :desired_capabilities caused NoMethodError (issue 4187).
-3.4.2 (2017-06-14)
-==================
-Ruby:
-  * Added unhandledPromptBehavior to the list of known capabilities.
-  * Added timeouts to the list of known capabilities.
-  * Fixed a regression when passing hash as :desired_capabilities caused NoMethodError (issue 4172, thanks Thomas Walpole).
-  * Fixed a regression when extension capabilities (the ones that have ":" inside)
-    were filtered out when doing protocol handshake.
-  * Improved handling of capability names passed as plain camelCased strings
-    vs Rubyish snake_cased symbols when doing protocol handshake.
-Chrome:
-  * Fixed a regression when passing :switches to driver initialization was ignored.
-3.4.1 (2017-06-13)
-==================
-Ruby:
-  * Implemented a new dual-dialect mechanism for communication with drivers
-    (a.k.a. protocol handshake). There shouldn't be any noticeable differences
-    but since this is a significant refactoring of internal APIs, some bugs
-    could slip into the release.
-  * Renamed ElementClickIntercepted to ElementClickInterceptedError.
-  * Renamed ElementNotInteractable to ElementNotInteractableError.
-  * Deprecated W3CCapabilities in favor of Capabilities (it was meant to be private API).
-  * Added a warning when trying to save screenshot without .png extension (thanks @abotalov).
-IE:
-  * Added support for both old IEDriver which uses OSS dialect of JSON wire
-    protocol (<= 3.4.0) and new IEDriver which uses W3C dialect (not yet released).
-Safari:
-  * Removed runtime dependencies used for old SafariDriver (u.g. websocket).
-Chrome:
-  * Added new Chrome::Options class that should be used to customize browser
-    behavior (command line arguments, extensions, preferences, mobile emulation, etc.).
-    The instance of options class can be passed to driver initialization using
-    :options key. Old way of passing these customization directly to driver
-    initialization is deprecated.
-Firefox:
-  * Added new Firefox::Options class that should be used to customize browser
-    behavior (command line arguments, profile, preferences, Firefox binary, etc.).
-    The instance of options class can be passed to driver initialization using
-    :options key. Old way of passing these customization directly to driver
-    initialization is deprecated.
-3.4.0 (2017-04-21)
-===================
-Edge:
-  * Fix bug when response is not wrapped with "value"
-Firefox:
-  * Support geckodriver v0.16
-Ruby:
-  * Support ElementClickIntercepted error from W3C spec
-  * Support ElementNotInteractable error from W3C spec
-  * Implement window rect commands
-  * Implement window minimize command
-3.3.0 (2017-03-07)
-===================
-Firefox:
-  * geckodriver v0.15 or later is required
-W3C:
-  * Support for command response data to be wrapped in a 'value' key
-  * Support for updated timeout formats
-3.2.2 (2017-03-01)
-===================
-Ruby:
-  * Fix bug for supporting Logger output on Ruby versions < 2.3
-  * Add more logging and adjust output levels
-Remote:
-  * Support for creating Remote session with browser name and url parameters
-3.2.1 (2017-02-24)
-===================
-Ruby:
-  * Fix bug for supporting Logger on Ruby versions < 2.3
-3.2.0 (2017-02-22)
-===================
-Ruby:
-  * Implement new Logger class
-  * Fix issue with chromedriver process leader incompatibility on Win7 (issue 3512)
-3.1.0 (2017-02-14)
-===================
-Firefox:
-  * implement W3C actions endpoint
-3.0.8 (2017-02-08)
-===================
-Firefox:
-  * Fix signature of element returned from #active_element
-3.0.7 (2017-02-06)
-===================
-Firefox:
-  * Fix signature of element arrays returned from #find_elements (issue 3471)
-3.0.6 (2017-02-05)
-===================
-Firefox:
-  * Implement W3C window position
-  * Update implementation for W3C send text to alert
-  * Implement timeout settings
-  * Remove default capabilities (thanks lmtierney)
-  * Fix signature of elements returned from #execute_script (thanks Thomas Walpole)
-3.0.5 (2016-12-27)
-===================
-Ruby:
-  * Support for Ruby 2.4.0 (Thanks jamespdo)
-3.0.4 (2016-12-21)
-===================
-Firefox:
-  * Implement profile support via geckodriver (#2933 thanks lmtierney)
-Ruby:
-  * Fix bug preventing use of Curb client (#2951 thanks clarkenciel)
-  * Support Net::HTTP::Persistent version 3 (#3219 thanks Pete Johns)
-  * Allow Net::HTTP::Default to set open_timout and read_timeout independently (#3264 thanks richseviora)
-  * Change default for Net::HTTP::Default#open_timeout to facilitate debuggers  (#3264 thanks richseviora)
-3.0.3 (2016-11-26)
-===================
-Ruby:
-  * Allow drivers to be executed from batch files on Windows
-3.0.2 (2016-11-25)
-===================
-Ruby:
-  * Implement #driver_path as parameter when initializing a driver (thanks lmtierney)
-  * Improve Ruby syntax in driver commands (thanks joe_schulte)
-  * Improve performance when shutting down drivers (thanks lmtierney)
-  * Fix bug for finding open ports on Windows (thanks kou1okada)
-  * Fix bug in auto detection of drivers which allowed selection of non-executable binaries
-W3C:
-  * Implement #cookie_named and #delete_all_cookies methods (thanks lmtierney)
-  * Implement element #property method (thanks lmtierney)
-Chrome:
-  * Fix bug in switches (thanks danvine)
-3.0.1 (2016-11-06)
-===================
-Ruby:
-  * Always send JSON Wire Protocol commands to server instead of W3C commands
-3.0.0 (2016-10-13)
-===================
-Firefox:
-  * Update :firefox_options support for geckodriver 0.11
-3.0.0.beta4 (2016-09-29)
-===================
-Ruby:
-  * Remove support for deprecated driver options
-  * Add support for latest driver options
-  * Add support for :port parameter for launching driver
-  * Add support for :service_args parameter for driver command line switches
-  * Improve reliability by increasing service shutdown timeout (#2815; thanks John Barbuto )
-Firefox:
-  * Add support for :firefox_options in geckodriver
-Safari:
-  * Remove support for legacy Safari driver (use Apple's driver built in to Safari 10+)
-Chrome:
-  * Set chromedriver to not log by default
-3.0.0.beta3.1 (2016-09-03)
-===================
-Firefox:
-  * Fixed bug - legacy firefox extension included in gem
-3.0.0.beta3 (2016-09-01)
-===================
-Firefox:
-  * Implemented w3c getAttribute with javascript atom
-3.0.0.beta2.1 (2016-08-03)
-===================
-Ruby:
-  * Fixed bug in collections
-3.0.0.beta2 (2016-08-02)
-===================
-Firefox:
-  * Fixed bug with form submission
-  * Improved w3c element handling
-3.0.0.beta1 (2016-07-28)
-===================
-Ruby:
-  * Remove support for RC client
-  * Remove support for Ruby < 2.0
-  * Update code to support designated style guidelines
-  * Chrome/GeckoDriver/PhantomJS/IE/Edge drivers are refactored to use standard
-    service class (issue 1797)
-  * Option `:timeout` was removed from IE server (issue 1797)
-Chrome:
-  * Remove override of default chromedriver behavior for chrome.detach (issue 2418)
-Firefox:
-  * Rename wires to geckodriver
-  * Change default usage from FirefoxDriver to geckodriver
-Safari:
-  * Initial support for Apple's Safari Driver in Sierra (issue #2475)
-Android and iPhone:
-  * Remove support for deprecated classes (Issue #2476)
-2.53.0 (2016-03-15)
-===================
-Ruby:
-  * Removed dependency on "multi_json" (issue 1632)
-  * Properly handle namespaces in install manifest of Firefox add-ons (issue 1143)
-  * Improve error handling when stopping browsers (thanks bsedat)
-  * Fix deselecting options in select lists (thanks glib-briia)
-  * Fix w3c error handling
-  * Update w3c Capabilities support
-IE:
-  * support for alert credentials (issue #1698, thanks Alan Baird & trabulmonkee)
-2.52.0 (2016-02-12)
-===================
-No Ruby changes in this release.
-2.51.0 (2016-02-05)
-===================
-No Ruby changes in this release.
-2.50.0 (2016-01-27)
-===================
-Firefox:
- * Fix bug for locating binary in local path  (issue 1523, thanks Gopal Patel)
-2.49.0 (2016-01-13)
-===================
-Ruby:
-  * support for SessionNotCreatedError (thanks Alexander Bayandin)
-Safari:
-  * Limit support to OS X (issue 1186)
-  * support for multiple concurrent drivers
-PhantomJS:
-  * Implement Socket locking
-IE:
-  * support for multiple concurrent drivers
-Chrome:
-  * prevent 404 error when shutting down Chrome service (thanks Fumiaki MATSUSHIMA)
-  * logging turned on by default
-  * support local storage capabilities
-Firefox:
-  * support setting the location of Firefox binary to use when run locally
-  * add default lookup of Homebrew Cask default directory (issue 1437)
-W3C Specification:
-  * support for using with Remote WebDriver
-  * implement window size command
-  * implement window position command
-  * implement element size command
-  * implement element position command
-  * implement full screen window command
-  * implement page source command
-2.48.1 (2015-10-13)
-===================
-Firefox:
-  * Mozilla's Wires Driver for Marionette works with Remote WebDriver
-2.48.0 (2015-10-07)
-===================
-Firefox:
-  * Initial implementation of Mozilla's Wires Driver for Marionette; Supported in version 43 and higher
-Edge:
-  * Fix execution with Remote Server
-  * Fix Javascript Execution
-  * Implement Alert Handling
-  * Implement Window Switching
-Ruby:
-  * Initial implementation of W3C WebDriver syntax to support Mozilla Wires
-  * Change to RSpec expect syntax
-  * Specs can be run from relative directories
-2.47.1 (2015-07-31)
-===================
-Edge:
-  * Initial implementation of Microsoft's EdgeDriver
-2.47.0 (2015-07-29)
-===================
-Safari:
-  * Remove support for installing additional extensions due to architectural changes introduced with Safari 7
-2.46.2 (2015-06-05)
-===================
-* Fix encoding issue which prevents Element#send_keys to work on Ruby < 2.0 (#621)
-2.46.1 (2015-06-04)
-===================
-  * Fix aborted rubygems.org release
-2.46.0 (2015-06-04)
-===================
-Firefox:
-  * Support for Firefox 38
-  * Fix performance bug by not forcing garbage collection in httpd.js
-Chrome:
-  * Fixed ChromeDriver port race condition (#449 - thanks Jason Anderson)
-Ruby changes:
-  * Retry binding to ports unavailable by EADDRNOTAVAIL (#394).
-  * Remove Presto-Opera support (Blink-based Opera still supported)
-2.45.0 (2015-02-28)
-===================
-Firefox:
-  * Native events in Firefox relied on an API that Mozilla no longer
-    provides. As such, fall back to synthesized events on recent Firefox
-    versions.
-Ruby changes:
-  * Allow switching windows when current window is closed (thanks Titus Fortner).
-  * Add :javascript_enabled to Android capabilities.
-2.44.0 (2014-10-05)
-===================
-No Ruby changes in this release.
-Firefox:
-  * Native event support for Firefox 24, 31, 32 and 33
-2.43.0 (2014-09-09)
-===================
-* Make sure UnhandledAlertErrors includes the alert text if provided by the driver.
-* Firefox
-  - Make sure the browser process is properly killed if silent startup hangs (#7392)
-  - native events support for Firefox 24, 31 and 32
-* Loosen websocket dependency to ~> 1.0
-* Add support for `switch_to.parent_frame` (thanks abotalov)
-* Fix download location for Selenium::Server.{latest,get} (#7049 - thanks marekj)
-2.42.0 (2014-05-23)
-===================
-Firefox:
-  * Fix for extensions whose install.rdf uses an attribute for em:id (#5978)
-  * Support for Firefox 29 Native Events
-2.41.0 (2014-03-28)
-===================
-* Removed dead browser visibility methods.
-* Firefox:
-  * Native events support for Firefox 28 (removed support for 26)
-2.40.0 (2014-02-19)
-===================
-* Fix bug where FileReaper would not reap files added in a child process
-* Document AbstractEventListener (#5994)
-* Safari:
-  * Add Safari::Options + clean up Safari extension handling (#6382)
-  * Add support for user extensions (#6815)
-* Firefox:
-  * Support native events for Firefox 27 + removed native event support for Firefox 25
-2.39.0 (2013-12-17)
-===================
-* Firefox: Native events support for Firefox 26.
-* Add deprecation warning to the Android driver.
-* Make sure selenium/client doesn't require Rake (#6709)
-2.38.0 (2013-12-05)
-===================
-* Enforce required Ruby version in gemspec, not just transitively through rubyzip.
-* Expose the logging API (beta API, subject to change) in the Ruby client: driver.manage.logs #=> Selenium::WebDriver::Logs
-* Update to support native events for Firefox 25
-2.37.0 (2013-10-18)
-===================
-* As of this version, selenium-webdriver no longer supports Ruby < 1.9.2
-* Depend on rubyzip ~> 1.0.0
-* Added SOCKS proxy support
-* Fixed support for SVG documents in the atoms.
-* Fixed computing an element's container dimensions to account for  the scrollbar size when scrolling
-* Added Capabilities.htmlunitwithjs
-Chrome:
-  * Pass through the prefs option as a Chrome capability (#5929).
-Firefox:
-  * Updated Firefox native event components to support Firefox 24.
-  * New elementScrollBehavior capability.
-  * Fixed getLocation to work on scrolled pages.
-  * Fixed autoscrolling for elements located in frames.
-  * Fixed drag-n-drop for elements in frames with native events
-IE:
-  * Use native events by default, also for remote IE (#4695)
-Safari:
-  * Enable screenshots and input devices in the client.
-2.35.1 (2013-08-26)
-===================
-* Depend on rubyzip < 1.0.0
-2.35.0 (2013-08-14)
-===================
-Firefox:
-  * Updated Firefox native event components to support Firefox 23.
-2.34.0 (2013-08-06)
-===================
-Remote:
-  * Add `Driver#remote_status` (remote driver only) (#5669)
-Firefox:
-  * Updated Firefox native event components to support Firefox 22.
-iPhone:
-  * The driver is now deprecated (see http://appium.io/ or http://ios-driver.github.io/ios-driver/ for a replacement)
-Various:
-  * Updated our copy of the Closure compiler and library to the most
-    recent versions.
-  * Updated the atoms library, including support for MS pointer events
-    and refinements to element visibility tests.
-  * Update synthesized mouse implementation. Mouse moves are
-    implemented using nsIDOMWindowUtils.
-  * Added support for the HTML5 "hidden" attribute. If an element, or
-    ancestor, has hidden attribute make, it is not shown.
-2.33.0 (2013-05-26)
-===================
-Remote:
-  * Support rotating devices, such as iPhone & iPad in simulator and Android browser in emulator
-  * Support for interacting with touch screen devices, such as iPhone & iPad in simulator and Android browser in emulator
-  * Improve error messages for invalid wire protocol responses
-Chrome:
-  * Accept :service_log_path for Chrome. (#3475)
-IE:
-  * IE >=9 versions triggerMouseEvent like other browsers (#2218).
-Various:
-  * Element#text ignores elements in <head>
-2.32.1 (2013-04-11)
-===================
-Safari:
-  * Fix typo when encoding the Safari server redirect URL (#5472)
-2.32.0 (2013-04-09)
-===================
-Safari:
-  * The Safari extension is now packaged with the gem and automatically installed (#5322)
-  * Improved detection of the binary location on 64-bit windows (#5273)
-Opera:
-  * Allow passing :desired_capabailities (#5279)
-Firefox:
-  * This release supports versions 10esr, 17esr, 19, 20.
-  * Improved SVG support
-Other:
-  * Allow #click_and_hold without target (#5410).
-  * Remove assumptions about returned capabilities (for ios-driver)
-2.31.0 (2013-03-02)
-===================
-Remote:
-  * Expose session_id on the remote driver when used directly (#5240).
-Firefox:
-  * Native events in Firefox 19
-Opera:
-  * Treat UNSPECIFIED proxy type as a nil proxy (#5081).
-Other:
-  * Add ability to pass :desired_capabilities to all the Ruby drivers, not just for :remote.
-    Direct arguments take presendence. (#5078, see also https://github.com/SeleniumHQ/selenium/pull/8, https://github.com/SeleniumHQ/selenium/pull/11)
-2.30.0 (2013-02-20)
-===================
-Firefox:
-  * Firefox 19 support (for synthesized events)
-Remote:
-  * Pass along firefox_binary correctly (#5152)
-Safari:
-  * Don't overwrite Driver#browser
-Other
-  * Alert#text should raise on closed alert.
-2.29.0 (2013-01-21)
-===================
-Firefox:
-  * Firefox 18 support (for native events).
-IE:
-  * New 'requireWindowFocus' desired capability.
-  * IE view port calculation take scroll bars into account (#3602)
-Safari:
-  * Replace 'libwebsocket' with 'websocket' gem. This should ensure
-    support with recent Safari.
-Other:
-  * Fix Cygwin issue in PortProber/Firefox::Bianry (#4963)
-2.27.2 (2012-12-11)
-===================
-Firefox:
-  * Fix for native events in v17 (packaging mistake)
-2.27.1 (2012-12-07)
-===================
-Firefox:
-  * Fix "g[b] is not an object" error when passing null to execute_script.
-2.27.0 (2012-12-06)
-===================
-Firefox:
-  * Support for Firefox 17.
-IE:
-  * Path to the server executable can be specified (S::W::IE.path=)
-Other:
-  * Added :phantomjs driver
-2.26.0 (2012-11-02)
-===================
-Firefox:
-  * Added support for native events for Firefox 15 and 16.
-  * Modified FirefoxDriver to use atoms to switch between frames.
-  * FIXED: 4309: 'Could not convert Native argument arg 0' error with Firefox.
-  * FIXED: 4375: Executing javascript hangs Firefox.
-  * FIXED: 4165: WebDriver fails on a machine with no IP address.
-Safari:
-  * Fixed SafariDriver to allow calling .quit() consecutively without error.
-  * FIXED: 4676: Unable to fire javascript events into SVG's.
-  * FIXED: 3969: SafariDriver should auto-dismiss alerts.
-IE:
-  * FIXED: 4535: Hover still does not work perfectly in IE.
-  * FIXED: 4593: Alert.accept() Cancels the Resend Alert/Dialog Box.
-2.25.0 (2012-07-19)
-===================
-* Respect no_proxy / NO_PROXY env vars (#4007).
-* Improve error message if a configured proxy refuses the connection.
-* Ignored exception can be configured on the Wait class.
-* Add Selenium::WebDriver::Support::Color class.
-* Ignore Errno::ENETUNREACH when trying to detect our local IP (#4165).
-* Ignore Errno::EADDRNOTAVAIL in PortProber (#3987).
-* Firefox:
-  * Enumerate through client rects until finding one with non-zero dimensions when clicking.
-  * Updated supported versions of Firefox to 17.
-  * Allow windows to be resized from a frame (#3897).
-  * Fix an issue where a call to submit could hang the driver.
-* IE:
-  * Ability to configure logging through the :log_file and :log_level options.
-  * Increasing stability of file upload dialog handling (#3858)
-* Better handling of overflow edge cases when determining element visibility.
-2.24.0 (2012-06-19)
-===================
-* bot.dom.getVisibleText does not properly handle display:run-in or display:table (#1584).
-* CSS selectors now support compound selectors.
-* IE:
-  * Failure to click on an element in the IE Driver will yield a more meaningful error.
-  * Crash on IE8 when S_FALSE is returned from get_Document (#4064)
-  * DLLs are no longer bundled with the gem, users must use the standalone server from now on.
-* Firefox:
-  * Support for Firefox 13
-  * Ability to pass :proxy directly as Firefox option (no Profile needed).
-2.22.2 (2012-06-05)
-===================
-* Improve method for determining the local IP (#3987).
-2.22.1 (2012-06-01)
-===================
-* Fix for 1.8.7 behaviour of Socket.getaddrinfo.
-* Automatically reap Firefox profile on exit, not just in #quit.
-2.22.0 (2012-05-29)
-===================
-* Fix conflict with ActiveSupport's Object#load (#3819)
-* IE:
-  * Default to standalone server executable, fall back to bundled DLLs.
-  * The 'nativeEvents' capabilitiy is exposed as :native_events in the Ruby client (mode still experimental).
-* Firefox:
-  * Native events for Firefox 12.
-  * Native events retained for Firefox 3.x, 10 and 11.
-  * Fix for typing in Firefox 12
-  * Fix for typing on XHTML pages (#3647)
-  * Fix for maximizing windows when switched to a frame (#3758)
-  * Handle alerts from nested iframes (#3825)
-* Remote:
-  * Honor HTTP_PROXY env vars (#3838).
-* Element#attribute returns nil if a boolean attribute is not present.
-* NoSuchWindowError will be thrown if the currently selected window is closed and another command is sent.
-* Safari:
-  * support for frame switching, snapshot taking, execute script
-  * message protocol changed, not backwards compatible with 2.21.
-* Style attributes are no longer lower-cased by default (#1089).
-* Make sure the Ruby client kills Firefox even when the RPC fails.
-* Make sure the Ruby client checks all network interfaces when finding free ports.
-2.21.2 (2012-04-18)
-===================
-* Check MultiJson.respond_to?, depend on ~> 1.0
-2.21.1 (2012-04-16)
-===================
-* Set multi_json dependency to < 1.3 to avoid deprecation warnings.
-2.21.0 (2012-04-11)
-===================
-* Add Selenium::WebDriver::Window#maximize (#3489)
-* Safari:
-  * New driver! See https://github.com/SeleniumHQ/selenium/wiki/SafariDriver.
-* Firefox:
-  * Significant stability improvements.
-  * Native events support for Firefox 11
-  * Dropped native events support for Firefox 4-9
-  * Window maximize implementation.
-* IE:
-  * Ignore invisible dialogs (#3360).
-  * Window maximize implementation.
-* Android:
-  * Accept SSL certificates (#3504).
-2.20.0 (2012-02-28)
-===================
-* Loosen the multi_json and ffi dependencies (#3446)
-* Firefox:
-  * Introduce a timeout for page loads. This needs to be used in
-    conjunction with the unstable page load detection. Exposed as
-    Timeouts#page_load=
-* Scroll containing elements, not just windows (#3391).
-* Element#{style => css_value}, with an alias for backwards compatibility.
-* Atoms:
-  * Submit a form when the enter button is pressed in its input
-    element.
-  * Add a "mouse pixel scroll" event to the atoms events module.
-  * Adding a public "mouseOver" action and a little internal
-    refactoring around the mouseOver functionality.
-* Selenium::WebDriver::Wait: polling interval reduced from 0.5 to 0.2 seconds.
-2.19.0 (2012-02-08)
-===================
-* RC client supports server-side WebDriver-backed Selenium.
-* Touch APIs implemented in the Ruby client (Android only)
-* Firefox:
-  * Fix deserialization of user.js in Firefox::Profile
-  * Native events implemented for Firefox 10.
-  * Renamed the experimental "fast" page loaded strategy "unstable"
-    and disable queuing of commands when it's enabled.
-  * Disabled native events for Firefox 8 as it's deprecated by Mozilla.
-  * Fix for exceptions thrown when an alert occurs during script execution.
-* Chrome:
-  * New download link for the server component:
-    http://code.google.com/p/chromedriver/downloads/list
-2.18.0 (2012-01-27)
-===================
-* Fix for getting value attribute of option elements. (#3169)
-* Firefox and IE:
-  * Raise UnhandledAlertError if an alert is present during an operation. The unhandled alert is also dismissed to mitigate repeat exceptions.
-* Firefox:
-  * Better handling of getText invocations on SVG elements.
-  * Fix for Element#click in Firefox 4. (#3253)
-  * Fixed bug when deserializing user.js in Firefox::Profile.
-  * Default profile preferences now read from shared JSON blob.
-* Android and iPhone:
-  * Client support for the geolocation API (see Selenium::WebDriver::DriverExtensions::HasLocation)
-  * Client support for the web storage API (see Selenium::WebDriver::DriverExtensions::HasWebStorage)
-* iPhone:
-  * Server now supports frame switching (for frames in the same domain).
-2.17.0 (2012-01-16)
-===================
-* Firefox:
-  * Fix excessive unwrapping when switching windows.
-  * Set toolkit.telemetry.{enabled,rejected} in the default Firefox profile.
-  * Support up to version 12 with synthesized events.
-  * Fixed issues launching Firefox 9 due to modal dialog (#3154, #3144)
-* Chrome:
-  * Now accepts a :url option, pointing to an already running Chrome server.
-  * Now accepts a :proxy option (i.e. Selenium::WebDriver::Proxy instance).
-* iPhone:
-  * iWebDriver will auto-play HTML5 video (#3152)
-* Element#attribute("value") falls back to the text of option tags, if no value attribute is specified (#3169)
-2.16.0 (2012-01-04)
-===================
-* Firefox:
-  * Native events support for Firefox 9
-  * Allow apps to use offline storage by default
-  * Fix excessive unwrapping when executing mouseMove
-  * Click in the middle, rather than the top-left of elements (#3034, #2700)
-* IE:
-  * Raise StaleElementReferenceError when interacting with elements outside the currently focused frame
-  * Handle frames and iframes in showModalDialog windows
-* Chrome:
-  * Improve client handling of invalid error responses
-* iPhone:
-  * Updated to latest CocoaHTTPServer
-* Remote:
-  * Improve performance of Element#== by only making an RPC when necessary.
-  * Disallow caching of GET requests
-* Various:
-  * Raise ArgumentError instead of UnsupportedOperationError on invalid modifier key
-  * Improve docs for Server, ActionBuilder and Window
-  * Update to latest Sizzle (used for :css selectors in older browsers)
-2.15.0 (2011-12-08)
-===================
-* Firefox:
-  * Now supports up to Firefox 11 (for syntesized events)
-  * Implicit waits now change how long we wait for alerts. This
-    functionality will change in 2.16
-  * Fix scrolling issue (#2700)
-* IE:
-  * Fix issue with getWindowHandles() and showModalDialog() (#1828)
-  * Add support for the window sizing and positioning API
-* Make Platform.bitsize use the correct constant from FFI
-* WebDriver internals:
-  * Atoms code contribution from Google
-  * Closure updated
-2.14.0 (2011-11-29)
-===================
-* Add Selenium::WebDriver::Support::Select class to ease working with select lists.
-* Add Capabilities.ipad and Capabilities.iphone (#2895)
-* Replace json_pure dependency with multi_json. (#2901)
-* Don't leave sockets hanging in SYN_SENT state while polling.
-* Allow selecting option elements even if the enclosing select has zero opacity.
-* Exception renames (old names aliased and will still work in rescues):
-  * ObsoleteElementError      -> StaleElementReferenceError
-  * UnhandledError            -> UnknownError
-  * UnexpectedJavascriptError -> JavascriptError
-  * NoAlertOpenError          -> NoAlertPresentError
-  * ElementNotDisplayedError  -> ElementNotVisibleError
-* Firefox:
-  * Fixed issue with scrolling on small viewports with native events.
-  * Fix CSS selector support in Firefox 3.0
-* IE:
-  * Implement the window control API
-2.13.0 (2011-11-18)
-===================
-* Firefox:
-  * Recovering from null window references in the Firefox driver (#1438)
-2.12.2 (2011-11-13)
-===================
-* Firefox
-  * Fix issue where Firefox 8 would throw permission errors after document.domain was modified (#2863).
-  * Force window to the foreground on launch (see https://bugzilla.mozilla.org/show_bug.cgi?id=566671)
-2.12.1 (2011-11-11)
-===================
-* Fix regression when typing into contenteditable elements.
-2.12.0 (2011-11-10)
-===================
-* Loosened the ffi dependency now that Windows support is back (#2755).
-* Fix shutdown issues when using net-http-persistent against remote servers.
-* Added beta window control API (see Selenium::WebDriver::Options#window).
-* Firefox
-  * Support for Firefox 8.
-  * Better reporting of page size when attempting to move out of bounds.
-  * Beta implementation of window control.
-2.11.0
-======
-(release skipped since it included only server-side changes)
-2.10.0 (2011-10-27)
-===================
-* Improve native keyboard emulation on Windows.
-* Allow commas in CSS selectors (#2301)
-* Firefox:
-  * Fix intermittent error when finding elements by XPath (#2099)
-  * Fix detection of maximum page size (#2700)
-  * Avoid extension selection dialog (extensions.autoDisableScopes)
-  * Fix invalid wire responses from the synthetic mouse (#2695)
-  * Don't scroll unnecessarily (#1771).
-* IE:
-  * Improve handling of #clear on disabled or readonly elements.
-2.9.1 (2011-10-24)
-==================
-* Workaround for invalid error responses (#2695).
-2.9.0 (2011-10-21)
-==================
-* Support file uploads to the remote server (see Selenium::WebDriver::DriverExtensions::UploadsFiles)
-* New exception: Selenium::WebDriver::Error::MoveTargetOutOfBoundsError
-* Implemented Chrome::Profile#add_extension
-* Better respect for preformatted text in Element#text
-* Reduced scrolling during tests for IE and Firefox.
-* Firefox:
-  * Support for experimental page load detection.
-* IE:
-  * Better detection of where to click on links (#2675).
-  * Improve handling of modal dialogs (showModalDialog).
-2.8.0 (2011-10-06)
-==================
-* Firefox
-  - Avoid telemetry prompt on Firefox 7
-  - Allow parallel execution with native events on Linux (#1326)
-  - Added native events support for Firefox 7 on Linux/Windows
-  - Improve search for libX11 for native events on Linux (#384)
-  - Fix double click with native events
-* Chrome
-  - Fail fast if the chromedriver server is not executable.
-* IE
-  - Fix find_element bug (#2563)
-2.7.0 (2011-09-23)
-==================
-* Firefox
-  - no longer types in the URL bar (#2487)
-  - fixed native events click() issue when element is out of view
-  - double click + get no longer hangs firefox (#2456)
-  - make sure escaped backslashes are properly escaped when serializing a Firefox profile (#2485)
-* IE
-  - fix event firing issue (#2516)
-* Opera
-  - don't start the remote service if the driver is passed bad arguments
-2.6.0 (2011-09-13)
-==================
-* Rescue and retry on Errno::EADDRINUSE to work around ephemeral ports issue on Windows.
-* Use correct default URL for the Android driver.
-* Profile zipping now follows symlinks (#2416).
-* Firefox
-  - Disable malware check
-  - Various #click improvements
-  - Don't scroll if element is already in view
-* IE:
-  - improve scrolling to elements with 'overflow: scroll'
-  - properly trigger jQuery change events (#2207)
-  - improve handling of nested modal dialogs
-* Opera:
-  - capabilities exposed as options to Selenium::WebDriver.for
-* Various iPhone driver fixes (e.g. #1396)
-2.5.0 (2011-08-23)
-==================
-* IE: support for double click and fix for clicks close to edge of window.
-* Fix for clicking links that overflow into multiple lines (#1020).
-* Correct initial cursor position when typing into text fields with Firefox 6.
-* Native events support for Firefox 6 on Windows and Linux.
-* Fix bug in Android::Bridge when no :http_client option was passed.
-* Set chrome.detach to tell chromedriver to leave browser running on exit.
-2.4.0 (2011-08-11)
-==================
-* Firefox 6 support.
-* Raise in switch_to.alert when no alert is present.
-* Improved handling of non-breaking spaces for Element#text.
-2.3.2 (2011-08-01)
-==================
-* Re-releasing since 2.3.1 was a buggy build.
-2.3.1 (2011-08-01)
-==================
-* Fix bug where Firefox would hang if Firefox::Profile#log_file= was set.
-2.3.0 (2011-08-01)
-==================
-* Add Selenium::WebDriver::Chrome::Profile
-* Better detection of clickable areas in Firefox.
-* Merge of Google-contributed code into the underlying Atoms.
-* IE click issue fixed (#1650)
-* No longer raise in Element#inspect if the element is obsolete.
-2.2.0 (2011-07-26)
-==================
-* Add ability to listen for WebDriver events
-* Fix Android/iPhone bridges to work similar to others (https://github.com/jnicklas/capybara/issues/425)
-* Various atoms fixes
-* Element equality now works properly with the remote server (#251).
-2.1.0 (2011-07-18)
-==================
-* Various improvments to the IE driver (#2049, #1870)
-* Atoms fixes (#1776, #1972).
-* Synthetic mouse clicks do not propagate errors in onmouseover.
-2.0.1 (2011-07-11)
-==================
-* Make sure at_exit hooks aren't inherited by child processes.
-2.0.0 (2011-07-08)
-==================
-* Remove deprecated methods Element#{toggle,select,drag_and_drop_*,value}.
-* Add ability to pass :verbose, :native_events to the Chrome driver.
-* Synthetic mouse implementation for Firefox - improves drag and drop support platforms without native events.
-* Added Selenium::WebDriver::Opera (requires the remote server).
-* Fix for locating Firefox on 64-bit Windows when missing from the registry.
-* Fix native events on Firefox 4, 5.
-0.2.2 (2011-06-22)
-==================
-* Deprecate Element#{toggle,select,drag_and_drop_*}
-* Chrome.path= now sets the path to Chrome, Chrome.driver_path= the path to the chromedriver server.
-* Fix argument names in Mouse#move_to and Mouse#move_by.
-* Support Firefox 5
-* Chrome and Firefox drivers now includes the HasInputDevices module.
-* Selenium::Rake::ServerTask now works with Rake 0.9.
-0.2.1 (2011-06-01)
-==================
-* Allow passing custom command line switches to Chrome (requires today's release of the Chrome server)
-* Avoid mutating arguments to find_element (issue #1273).
-* Avoid conflicts when SUT modifies Array.prototype
-* Allow setting arbitrary capabilities by adding Capabilities#[]=
-* The Chrome driver is extended with TakesScreenshot.
-* IE driver detects bad protected mode settings.
-* Firefox driver no longer considers opacity when determining visibility.
-* Fix for ActionBuilder#move_by.
-* Treat Errno::EBADF as an indication that we failed to grab the socket lock (issue #1611).
-* Ensure Firefox launches don't hang on some Ruby versions (by improving Selenium::WebDriver::SocketPoller).
-* Various internal driver improvements.
-0.2.0 (2011-04-22)
-==================
-* Update Ruby bindings to use the rewritten Chrome driver (see https://github.com/SeleniumHQ/selenium/wiki/ChromeDriver).
-* Add deprecation warning for WebDriver::Element#value (use Element#attribute("value") instead).
-* Change the default timeout for Wait instances to 5 seconds.
-* Fix bug where locators would fail if Object.prototype had been modified.
-* Various IE fixes
-  - Issues: #698, #1444
-  - Improved handling of showModalDialog()
-  - Full-size screenshots
-* Allow users to override the dom.max_script_run_time preference in Firefox.
-* Removed DesiredCapabilities.safari, which was never supported anyway.
-* Add DesiredCapabilities.opera, which will be supported in the Remote server if OperaDriver is on the classpath.
-* Print warnings for deprecated constants in the RC client:
-  - Selenium::SeleniumDriver => Selenium::Client::Driver
-  - Selenium::CommandError   => Selenium::Client::CommandError
-* Removed top-level constants:
-  - SeleniumHelper (available as Selenium::Client::SeleniumHelper)
-  - SeleniumCommandError (available as Selenium::Client::CommandError)
-0.1.4 (2011-03-21)
-==================
-* Support for Firefox 4.
-* Search PATH for Firefox / Chrome on OS X as well.
-* Bump dependencies for ffi and childprocess (#1356).
-* Find module renamed to SearchContext
-* Deprecated methods Driver#hover and Options#{speed,speed=} removed.
-* Improve IE driver stability, IE9 support
-* Added basic ActionBuilder and HasInputDevices#action. Not applicable for all browsers.
-* Added Driver#execute_async_script
-* Some WebDriver exception classes have been renamed to match its Java equivalents:
-    ElementNotEnabledError   -> InvalidElementStateError
-    UnknownScriptResultError -> XpathLookupError
-* Fix bug where Element#disabled? would alternate between true/false (r11438)
-0.1.3 (2011-02-14)
-==================
-* Several crashing bugs fixed in the IE driver.
-* Alert API available through the remote driver.
-* Driver#refresh fixed in the IE driver.
-* Fixed paths for IE DLLs on Cygwin.
-* Screenshot support in the IE and Remote drivers.
-* Fix #1152 by avoiding IPv6 loopback.
-* Added Mouse and Keyboard classes, accessible as Driver#{mouse,keyboard}. Considered experimental (IE + HtmlUnit only at the moment).
-* Automation atoms now used extensively in the IE driver.
-* Firefox::Bridge is now easier to extend (i.e. with a custom launcher).
-* Add S::W::Remote::Http::Persistent (currently only usable with the remote server).
-* IE driver passes along options like the other remote drivers, enabling user-specified HTTP clients.
-* :firefox_profile added to Remote::Capabilities, enabling passing a profile to remote Firefoxes.
-* IE driver now supports launching multiple instances of the browser.
-* Remove some Ruby warnings (uninitialized ivars, URI.escape).
-0.1.2 (2010-12-22)
-==================
-* Changed frame switching behaviour (http://groups.google.com/group/selenium-developers/browse_thread/thread/8dc7938c35bb3968)
-* IE driver rewrite landed.
-* Initial support for alerts/prompts (in Firefox).
-* Cygwin support.
-* Driver#execute_script now properly wraps elements inside Hashes.
-* Various fixes for Firefox 4.
-0.1.1 (2010-11-29)
-==================
-* Fix for Chrome.path=
-* Remote drivers always add Content-Length for POST requests (thanks joshuachisholm)
-* Fix for JS execution bug in the IE driver
-* Add ability to specify a proxy on the Http::Default client.
-* The remote drivers' :http_client argument now take a configured instance.
-0.1.0 (2010-11-11)
-===================
-* selenium-client code (Se1/RC client) is now included in the gem (require "selenium/client").
-* Add Selenium::WebDriver::Proxy, used to configure proxies for Firefox::Profile and the remote driver.
-* Tweaked Firefox profile preferences, improve logging, disabled crash reporter.
-* Reap Firefox profiles on close, not just on exit.
-* Add selenium/rake/server_task and selenium/server which wraps the Selenium server jar.
-* Various Firefox driver improvements (GC race conditions ++).
-* IE::Bridge#initialize now takes an options hash like the other bridges.
-* Added basic iPhone and Android driver classes.
-* Firefox driver now works on FreeBSD.
-0.0.29 (2010-10-09)
-===================
-* Element#find_element with :xpath follows the XPath spec (i.e. results are not limited to the receiver's subtree).
-* Element#attribute(attribute) now returns "false" instead of nil.
-* Firefox::Profile instances can now be reused for multiple drivers.
-* Redirect Firefox console logs to a file with Firefox::Profile.log_file=
-* Added a simple Wait class, based on WebDriverWait in Java.
-* Search PATH for Firefox executable on Windows also.
-* Added Capabilities.android
-* Fix saving of screenshots on Windows and Ruby 1.9 (using "wb" mode string)
-* CSS selector support in the remote driver
-* CSS selector support for IE (using querySelector when available, Sizzle elsewhere)
-* CSS selector support for older versions of Firefox (through Sizzle)
-* Cookie expiration dates are now handled correctly (#730)
-* Make Driver#bridge private, since this seems to be a common cause of confusion.
-* Add {Element,Remote::Capabilities}#as_json for Rails 3 (http://jonathanjulian.com/2010/04/rails-to_json-or-as_json/)
-* User can configure path to exectuables with {Firefox,Chrome}.path = "/some/path"
-* Added "chromium" as a possible name for the Chrome binary (#769)
-* Correctly set the HTTP client timeout (#768)
-* switch_to.window with block now handles exceptions and non-local returns.
-* switch_to.window with block returns the result of the block.
-* Extracted handling of child processes to a separate gem: http://github.com/jarib/childprocess
-0.0.28 (2010-08-23)
-===================
-* Fix behaviour of Element#==, Element#eql? and Element#hash (#hash still has issues on IE / remote).
-* Include remote server backtrace in raised errors (if available).
-* Chrome: Untrusted certificate support.
-* IE: Fix NoMethodError when getElementAttribute returns nil.
-* Driver#[] shorthand can take a locator hash, not just an id string.
-0.0.27 (2010-07-22)
-===================
-* Fixes for Element#attribute on IE / Firefox
-0.0.26 (2010-07-19)
-===================
-* Work around Curb issue: http://github.com/taf2/curb/issues/issue/40
-0.0.25 (2010-07-19)
-===================
-* Prevent Firefox from launching in offline mode (issue #587).
-* Add ability to set Firefox' binary path through Selenium::WebDriver::Firefox::Binary.path=
-* Add ability to install Firefox XPIs through Profile#add_extension.
-* Better packaging/building of Firefox/Chrome extensions, which adds rubyzip as a dependency.
-* Remote client supports HTTPS (issue #613 - thanks kkaempf).
-* Fix error message for TimeOutError in the IE driver (issue #602)
-* Add ability to use Chrome's default profile.
-* Fix for frame behaviour in Chrome (issue #273).
-* Standard gem directory structure (issue #475).
-0.0.24 (2010-06-17)
-==================
-* Fix issues with quitting Firefox/Chrome on Windows + MRI.
-0.0.23 (2010-06-15)
-===================
-* Improved the HTTP clients:
-  - hopefully fix some occasional socket errors on Windows
-  - rescue error on driver.close() with curb
-0.0.22 (2010-06-11)
-===================
-* Bugfix: Workaround for http://github.com/taf2/curb/issues/issue/33 - curb would sometimes use DELETE for GET requests.
-* Minor doc fix
-* Add ability to set timeout for HTTP clients
-0.0.21 (2010-06-11)
-===================
-* User can specify :http_client for the Firefox driver.
-* Refactor HTTP client code
-* Add Remote::Http::Curb as an alternative to the default (net/http) client.
-0.0.20 (2010-06-03)
-===================
-* Fix bug where Firefox would hang on quit().
-0.0.19 (2010-05-31)
-===================
-* Add a max redirect check to the remote driver
-* Add Firefox::Profile#assume_untrusted_certificate_issuer=
-* Add implicit waits (Selenium::WebDriver::Timeouts)
-* at_exit hook to clean temporary profiles
-* Fix for Errno::ECONNABORTED errors on Windows
-* Fix issue where Firefox::Profile#secure_ssl= would have no effect
-* Fix issue where locating elements by :css would fail in the Chrome driver.
-* IE driver now works on 64-bit rubies.