selenium-webdriver 4.1.2 → 4.2.0

package/CHANGES.md

@@ -1,3 +1,13 @@
+## v4.2.0
+
+* Delete old android-driver
+* Remove Opera support from JS bindings #10379
+* Handle a breaking changes in os.networkInterfaces (#10611)
+* Add support to switch frame by id
+* Add support to switch frame by name (#10670)
+* [cdp] add support Chrome 102 and remove for Chrome 98
+* Update implementation for submitting forms
+
 ## v4.1.2
 
 * chore/connect to CDP based on ENV selenium address var (#10255)
@@ -106,7 +116,7 @@
 ## v4.0.0-beta.1
 
 * JS Binding support for WebDriver Bidi in Firefox
-    - This requires Firefox 87 and Geckodriver 0.29 to be able to work
+  - This requires Firefox 87 and Geckodriver 0.29 to be able to work
 * Update the supported CDP versions
 * Update tmp package version (#9155)
 * Adding support for /computedlabel (getAccessibleName) (#9073)
@@ -120,11 +130,11 @@
 
 * Rolling back native support for Opera Browser
 * Added new ieOptions capabilities:
-    - fileUploadDialogTimeout
-    - setEdgePath
-    - setEdgeChromium
-    - setScrollBehavior
-    - For consistent naming, deprecating `addArguments(...args)` in favor of `addBrowserCommandSwitches(...args)`
+  - fileUploadDialogTimeout
+  - setEdgePath
+  - setEdgeChromium
+  - setScrollBehavior
+  - For consistent naming, deprecating `addArguments(...args)` in favor of `addBrowserCommandSwitches(...args)`
 
 * Added relative locators
 * Added Chrome DevTools Protocol (CDP) support
@@ -180,32 +190,28 @@ mode (see `example/headless.js`)
 ### Changes for W3C WebDriver Spec Compliance
 
 * Revamped the actions API to conform with the WebDriver Spec:
-  <https://www.w3.org/TR/webdriver/#actions>. For details, refer to the JS doc on
-  the `lib/input.Actions` class.
+  <https://www.w3.org/TR/webdriver/#actions>. For details, refer to the JS doc on the `lib/input.Actions` class.
 
   As of January, 2018, only Firefox natively supports this new API. You can put the `Actions` class
   into "bridge mode" and it will attempt to translate mouse and keyboard actions to the legacy API (
-  see class docs). Alternatively, you may continue to use the legacy API directly via
-  the `lib/actions` module.
+  see class docs). Alternatively, you may continue to use the legacy API directly via the `lib/actions` module.
   __NOTE:__ The legacy API is considered strongly deprecated and will be removed in a minor release
   once Google's Chrome and Microsoft's Edge browsers support the new API.
 
 * All window manipulation commands are now supported.
 * Added `driver.switchTo().parentFrame()`
-* When a named cookie is requested, attempt to fetch it directly using the W3C
-  endpoint, `GET /session/{session id}/cookie/{name}`. If this command is not recognized by the
+* When a named cookie is requested, attempt to fetch it directly using the W3C endpoint, `GET /session/{session id}/cookie/{name}`. If this command is not recognized by the
   remote end, fallback to fetching all cookies and then searching for the desired name.
-* Replaced `WebElement.getSize()` and `WebElement.getLocation()` with a single
-  method, `WebElement.getRect()`.
+* Replaced `WebElement.getSize()` and `WebElement.getLocation()` with a single method, `WebElement.getRect()`.
 
 ### API Changes
 
 * The core WebDriver API no longer uses promise manager
-    - Removed `index.Builder#setControlFlow()`
-    - The following thenable types no longer have a `cancel()` method:
-    - The dynamically generated thenable WebDrivers created by `index.Builder`
-    - `lib/webdriver.AlertPromise`
-    - `lib/webdriver.WebElementPromise`
+  - Removed `index.Builder#setControlFlow()`
+  - The following thenable types no longer have a `cancel()` method:
+  - The dynamically generated thenable WebDrivers created by `index.Builder`
+  - `lib/webdriver.AlertPromise`
+  - `lib/webdriver.WebElementPromise`
 * Removed `remote/index.DriverService.prototype.stop()` (use `#kill()` instead)
 * Removed the `lib/actions` module
 * Removed the `lib/events` module
@@ -213,127 +219,124 @@ mode (see `example/headless.js`)
 * Removed the 'opera' module
 * Removed the promise manager from `lib/promise`, which includes the removal of the following
   exported names (replacements, if any, in parentheses):
-    - CancellableThenable
-    - CancellationError
-    - ControlFlow
-    - Deferred
-    - LONG_STACK_TRACES
-    - MultipleUnhandledRejectionError
-    - Promise (use native Promises)
-    - Resolver
-    - Scheduler
-    - Thenable
-    - USE_PROMISE_MANAGER
-    - all (use Promise.all)
-    - asap (use Promise.resolve)
-    - captureStackTrace (use Error.captureStackTrace)
-    - consume (use async functions)
-    - controlFlow
-    - createPromise (use new Promise)
-    - defer
-    - fulfilled (use Promise.resolve)
-    - isGenerator
-    - rejected (use Promise.reject)
-    - setDefaultFlow
-    - when (use Promise.resolve)
+  - CancellableThenable
+  - CancellationError
+  - ControlFlow
+  - Deferred
+  - LONG_STACK_TRACES
+  - MultipleUnhandledRejectionError
+  - Promise (use native Promises)
+  - Resolver
+  - Scheduler
+  - Thenable
+  - USE_PROMISE_MANAGER
+  - all (use Promise.all)
+  - asap (use Promise.resolve)
+  - captureStackTrace (use Error.captureStackTrace)
+  - consume (use async functions)
+  - controlFlow
+  - createPromise (use new Promise)
+  - defer
+  - fulfilled (use Promise.resolve)
+  - isGenerator
+  - rejected (use Promise.reject)
+  - setDefaultFlow
+  - when (use Promise.resolve)
 * Changes to the `Builder` class:
-    - Added setChromeService, setEdgeService, & setFirefoxService
-    - Removed setEnableNativeEvents
-    - Removed setScrollBehavior
+  - Added setChromeService, setEdgeService, & setFirefoxService
+  - Removed setEnableNativeEvents
+  - Removed setScrollBehavior
 * Changes to `chrome.Driver`
-    - Added sendDevToolsCommand
-    - Added setDownloadPath
+  - Added sendDevToolsCommand
+  - Added setDownloadPath
 * Changes to `chrome.Options`
-    - Now extends the `Capabilities` class
-    - Removed from/toCapabilities
+  - Now extends the `Capabilities` class
+  - Removed from/toCapabilities
 * Changes to `edge.Options`
-    - Now extends the `Capabilities` class
-    - Removed from/toCapabilities
+  - Now extends the `Capabilities` class
+  - Removed from/toCapabilities
 * Changes to `ie.Options`
-    - Now extends the `Capabilities` class
-    - Removed from/toCapabilities
-* Removed the `firefox.Binary` class. Custom binaries can still be selected
-  using `firefox.Options#setBinary()`. Likewise, custom binary arguments can be specified
+  - Now extends the `Capabilities` class
+  - Removed from/toCapabilities
+* Removed the `firefox.Binary` class. Custom binaries can still be selected using `firefox.Options#setBinary()`. Likewise, custom binary arguments can be specified
   with `firefox.Options#addArguments()`.
 * Changes to `firefox.Driver`
-    - Added installAddon(path)
-    - Added uninstallAddon(id)
+  - Added installAddon(path)
+  - Added uninstallAddon(id)
 * Changes to `firefox.Options`
-    - Now extends the `Capabilities` class
-    - Removed from/toCapabilities
-    - Removed setLoggingPreferences (was a no-op)
-    - setProfile now only accepts a path to an existing profile
-    - Added addExtensions
-    - Added setPreference
-* Removed the `firefox.Profile` class. All of its functionality is now provided directly
-  by `firefox.Options`
+  - Now extends the `Capabilities` class
+  - Removed from/toCapabilities
+  - Removed setLoggingPreferences (was a no-op)
+  - setProfile now only accepts a path to an existing profile
+  - Added addExtensions
+  - Added setPreference
+* Removed the `firefox.Profile` class. All of its functionality is now provided directly by `firefox.Options`
 * Removed the `firefox/binary` module
 * Removed the `firefox/profile` module
 * Changes to `safari.Options`
-    - Now extends the `Capabilities` class
-    - Removed from/toCapabilities
-    - Removed setCleanSession (was a no-op)
+  - Now extends the `Capabilities` class
+  - Removed from/toCapabilities
+  - Removed setCleanSession (was a no-op)
 * Changes to `lib/capabilities.Browser`:
-    - Removed several enum values.
-        - ANDROID (use Chrome for Android; see docs on the chrome module)
-        - IPAD (no support available)
-        - IPHONE (no support available)
-        - OPERA (use Chrome)
-        - PHANTOM_JS (use Chrome or Firefox in headless mode)
-        - HTMLUNIT (use Chrome or Firefox in headless mode)
+  - Removed several enum values.
+    - ANDROID (use Chrome for Android; see docs on the chrome module)
+    - IPAD (no support available)
+    - IPHONE (no support available)
+    - OPERA (use Chrome)
+    - PHANTOM_JS (use Chrome or Firefox in headless mode)
+    - HTMLUNIT (use Chrome or Firefox in headless mode)
 * Changes to `lib/capabilities.Capabilities`:
-    - Removed static factory methods android(), ipad(), iphone(), opera(), phantomjs(), htmlunit(),
-      and htmlunitwithjs(). Users can still manually configure capabilities for these, but their use
-      is not recommended and they will no longer be surfaced in the API.
+  - Removed static factory methods android(), ipad(), iphone(), opera(), phantomjs(), htmlunit(),
+    and htmlunitwithjs(). Users can still manually configure capabilities for these, but their use
+    is not recommended and they will no longer be surfaced in the API.
 * Changes to `lib/error`:
-    - Added
-        - ElementClickInterceptedError
-        - InsecureCertificateError
-        - InvalidCoordinatesError
-        - NoSuchCookieError
-    - Removed
-        - ElementNotVisibleError
-        - InvalidElementCoordinatesError
+  - Added
+    - ElementClickInterceptedError
+    - InsecureCertificateError
+    - InvalidCoordinatesError
+    - NoSuchCookieError
+  - Removed
+    - ElementNotVisibleError
+    - InvalidElementCoordinatesError
 * Changes to `lib/webdriver.WebDriver`:
-    - Dropped support for "requiredCapabilities" from WebDriver.createSession
-    - actions() now returns the new `lib/input.Actions` class
-    - Removed touchActions
-    - Renamed schedule to execute
-    - Removed the `WebDriver.attachToSession()` factory method. Users can just the `WebDriver`
-      constructor directly instead.
-    - Removed the `call()` method. This was used to inject custom function calls into the control
-      flow. Now that the promise manager is no longer used, this method is no longer necessary.
-      Users are now responsible for coordinating actions (ideally with async functions) and can just
-      call functions directly instead of through `driver.call()`.
+  - Dropped support for "requiredCapabilities" from WebDriver.createSession
+  - actions() now returns the new `lib/input.Actions` class
+  - Removed touchActions
+  - Renamed schedule to execute
+  - Removed the `WebDriver.attachToSession()` factory method. Users can just the `WebDriver`
+    constructor directly instead.
+  - Removed the `call()` method. This was used to inject custom function calls into the control
+    flow. Now that the promise manager is no longer used, this method is no longer necessary. Users are now responsible for coordinating actions (ideally with async functions) and can just
+    call functions directly instead of through `driver.call()`.
 * Changes to `lib/webdriver.WebElement`:
-    - Replaced getSize & getLocation with getRect
+  - Replaced getSize & getLocation with getRect
 * Changes to `lib/webdriver.Alert`:
-    - Removed authenticateAs
+  - Removed authenticateAs
 * Changes to `lib/webdriver.Options` (`driver.manage()`):
-    - Removed timeouts (use get/setTimeouts)
+  - Removed timeouts (use get/setTimeouts)
 * Changes to `lib/webdriver.Window` (`driver.manage().window()`):
-    - Added
-        - getRect
-        - setRect
-        - fullscreen
-        - minimize
-    - Removed (use the getRect/setRect methods)
-        - getPosition
-        - setPosition
-        - getSize
-        - setSize
+  - Added
+    - getRect
+    - setRect
+    - fullscreen
+    - minimize
+  - Removed (use the getRect/setRect methods)
+    - getPosition
+    - setPosition
+    - getSize
+    - setSize
 * Removed the `testing/assert` module
 * Changes to `testing/index`
-    - Since the promise manager has been removed, it is no longer necessary to wrap the Mocha test
-      hooks; instead, users can simply use async functions. The following have all been removed:
-        - describe
-        - before
-        - beforeEach
-        - after
-        - afterEach
-        - it
-    - Added the `suite` function. For details, refer to the jsdoc or
-      `example/google_search_test.js`
+  - Since the promise manager has been removed, it is no longer necessary to wrap the Mocha test
+    hooks; instead, users can simply use async functions. The following have all been removed:
+    - describe
+    - before
+    - beforeEach
+    - after
+    - afterEach
+    - it
+  - Added the `suite` function. For details, refer to the jsdoc or
+    `example/google_search_test.js`
 
 ## v3.6.0
 
@@ -349,18 +352,18 @@ mode (see `example/headless.js`)
 ### API Changes
 
 * Added new methods to `selenium-webdriver/firefox.Options`:
-    - addArguments()
-    - headless()
-    - windowSize()
+  - addArguments()
+  - headless()
+  - windowSize()
 * Deprecated `selenium-webdriver/firefox/binary.Binary`
 * Removed `selenium-webdriver/firefox.Options#useGeckoDriver()`
 * Removed the unused `selenium-webdriver/firefox/profile.decode()`
 * Removed methods from `selenium-webdriver/firefox/profile.Profile` that had no effect since support
   for the legacy FirefoxDriver was dropped in 3.5.0:
-    - setNativeEventsEnabled
-    - nativeEventsEnabled
-    - getPort
-    - setPort
+  - setNativeEventsEnabled
+  - nativeEventsEnabled
+  - getPort
+  - setPort
 * Removed `selenium-webdriver/firefox.ServiceBuilder#setFirefoxBinary()`; custom binaries should be
   configured through the `firefox.Options` class.
 * Removed `selenium-webdriver/firefox.Capability`. These hold overs from the legacy FirefoxDriver
@@ -382,12 +385,11 @@ to a remote Selenium server that supports Firefox 45.
 ### Changes
 
 * Removed native support for Firefox 46 and older.
-    - The `SELENIUM_MARIONETTE` enviornment variable no longer has an effect.
-    - `selenium-webdriver/firefox.Capability.MARIONETTE` is deprecated.
-    - `selenium-webdriver/firefox.Options#useGeckoDriver()` is deprecated and now a no-op.
+  - The `SELENIUM_MARIONETTE` enviornment variable no longer has an effect.
+  - `selenium-webdriver/firefox.Capability.MARIONETTE` is deprecated.
+  - `selenium-webdriver/firefox.Options#useGeckoDriver()` is deprecated and now a no-op.
 * `firefox.Options` will no longer discard the `"moz:firefoxOptions"` set in user provided
-  capabilities (via `Builder.withCapabilities({})`). When both are used, the settings
-  in `firefox.Options` will be applied _last_.
+  capabilities (via `Builder.withCapabilities({})`). When both are used, the settings in `firefox.Options` will be applied _last_.
 * Added `chrome.Options#headless()` and `chrome.Options#windowSize()`, which may be used to start
   Chrome in headless mode (requires Chrome 59+) and to set the initial window size, respectively.
 
@@ -439,8 +441,7 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
 ## v3.1.0
 
 * The `lib` package is once again platform agnostic (excluding `lib/devmode`).
-* Deprecated `promise.when(value, callback, errback)`.
-  Use `promise.fulfilled(value).then(callback, errback)`
+* Deprecated `promise.when(value, callback, errback)`. Use `promise.fulfilled(value).then(callback, errback)`
 * Changed `promise.fulfilled(value)`, `promise.rejected(reason)` and
   `promise.defer()` to all use native promises when the promise manager is disabled.
 * Properly handle W3C error responses to new session commands.
@@ -457,10 +458,9 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
 ## v3.0.1
 
 * More API adjustments to align with native Promises
-    - Deprecated `promise.fulfilled(value)`, use `promise.Promise#resolve(value)`
-    - Deprecated `promise.rejected(reason)`, use `promise.Promise#reject(reason)`
-* When a `wait()` condition times out, the returned promise will now be rejected with
-  an `error.TimeoutError` instead of a generic `Error` object.
+  - Deprecated `promise.fulfilled(value)`, use `promise.Promise#resolve(value)`
+  - Deprecated `promise.rejected(reason)`, use `promise.Promise#reject(reason)`
+* When a `wait()` condition times out, the returned promise will now be rejected with an `error.TimeoutError` instead of a generic `Error` object.
 * `WebDriver#wait()` will now throw a TypeError if an invalid wait condition is provided.
 * Properly catch unhandled promise rejections with an action sequence (only impacts when the promise
   manager is disabled).
@@ -487,19 +487,17 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
   `SELENIUM_PROMISE_MANAGER=0`. This is part of a larger plan to remove the promise manager, as
   documented at
   <https://github.com/SeleniumHQ/selenium/issues/2969>
-* When communicating with a W3C-compliant remote end, use the atoms library for
-  the `WebElement.getAttribute()` and `WebElement.isDisplayed()` commands. This behavior is
+* When communicating with a W3C-compliant remote end, use the atoms library for the `WebElement.getAttribute()` and `WebElement.isDisplayed()` commands. This behavior is
   consistent with the java, .net, python, and ruby clients.
 
 ### API Changes
 
 * Removed `safari.Options#useLegacyDriver()`
 * Reduced the API on `promise.Thenable` for compatibility with native promises:
-    - Removed `#isPending()`
-    - Removed `#cancel()`
-    - Removed `#finally()`
-* Changed all subclasses of `webdriver.WebDriver` to overload the static
-  function `WebDriver.createSession()` instead of doing work in the constructor. All constructors
+  - Removed `#isPending()`
+  - Removed `#cancel()`
+  - Removed `#finally()`
+* Changed all subclasses of `webdriver.WebDriver` to overload the static function `WebDriver.createSession()` instead of doing work in the constructor. All constructors
   now inherit the base class' function signature. Users are still encouraged to use the `Builder`
   class instead of creating drivers directly.
 * `Builder#build()` now returns a "thenable" WebDriver instance, allowing users to immediately
@@ -512,10 +510,8 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
 
 * Fixed a bug where the promise manager would silently drop callbacks after recovering from an
   unhandled promise rejection.
-* Added the `firefox.ServiceBuilder` class, which may be used to customize the geckodriver used
-  for `firefox.Driver` instances.
-* Added support for Safari 10 safaridriver. safaridriver may be disabled via tha
-  API, `safari.Options#useLegacyDriver`, to use the safari extension driver.
+* Added the `firefox.ServiceBuilder` class, which may be used to customize the geckodriver used for `firefox.Driver` instances.
+* Added support for Safari 10 safaridriver. safaridriver may be disabled via tha API, `safari.Options#useLegacyDriver`, to use the safari extension driver.
 * Updated the `lib/proxy` module to support configuring a SOCKS proxy.
 * For the `promise.ControlFlow`, fire the "uncaughtException" event in a new turn of the JS event
   loop. As a result of this change, any errors thrown by an event listener will propagate to the
@@ -566,8 +562,7 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
 * Properly configure proxies when using the geckodriver
 * `http.Executor` now accepts a promised client. The `builder.Builder` class will now use this
   instead of a `command.DeferredExecutor` when creating WebDriver instances.
-* For Chrome and Firefox, the `builder.Builder` class will always return an
-  instanceof `chrome.Driver` and `firefox.Driver`, respectively, even when configured to use a
+* For Chrome and Firefox, the `builder.Builder` class will always return an instanceof `chrome.Driver` and `firefox.Driver`, respectively, even when configured to use a
   remote server (from `builder.Builder#usingServer(url)`,
   `SELENIUM_REMOTE_URL`, etc).
 
@@ -580,32 +575,32 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
   _seconds_ since epoch. When retrieving cookies, the expiration is always returned in seconds.
 * Renamed `firefox.Options#useMarionette` to `firefox.Options#useGeckoDriver`
 * Removed deprecated modules:
-    - `selenium-webdriver/error` (use `selenium-webdriver/lib/error`,\
-      or the `error` property exported by `selenium-webdriver`)
-    - `selenium-webdriver/executors` — this was not previously deprecated, but is no longer used.
+  - `selenium-webdriver/error` (use `selenium-webdriver/lib/error`,\
+    or the `error` property exported by `selenium-webdriver`)
+  - `selenium-webdriver/executors` — this was not previously deprecated, but is no longer used.
 * Removed deprecated types:
-    - `command.DeferredExecutor` — this was not previously deprecated, but is no longer used. It can
-      be trivially implemented by clients should it be needed.
-    - `error.InvalidSessionIdError` (use `error.NoSuchSessionError`)
-    - `executors.DeferredExecutor`
-    - `until.Condition` (use `webdriver.Condition`)
-    - `until.WebElementCondition` (use `webdriver.WebElementCondition`)
-    - `webdriver.UnhandledAlertError` (use `error.UnexpectedAlertOpenError`)
+  - `command.DeferredExecutor` — this was not previously deprecated, but is no longer used. It can
+    be trivially implemented by clients should it be needed.
+  - `error.InvalidSessionIdError` (use `error.NoSuchSessionError`)
+  - `executors.DeferredExecutor`
+  - `until.Condition` (use `webdriver.Condition`)
+  - `until.WebElementCondition` (use `webdriver.WebElementCondition`)
+  - `webdriver.UnhandledAlertError` (use `error.UnexpectedAlertOpenError`)
 * Removed deprecated functions:
-    - `Deferred#cancel()`
-    - `Deferred#catch()`
-    - `Deferred#finally()`
-    - `Deferred#isPending()`
-    - `Deferred#then()`
-    - `Promise#thenCatch()`
-    - `Promise#thenFinally()`
-    - `WebDriver#isElementPresent()`
-    - `WebElement#getInnerHtml()`
-    - `WebElement#getOuterHtml()`
-    - `WebElement#getRawId()`
-    - `WebElement#isElementPresent()`
+  - `Deferred#cancel()`
+  - `Deferred#catch()`
+  - `Deferred#finally()`
+  - `Deferred#isPending()`
+  - `Deferred#then()`
+  - `Promise#thenCatch()`
+  - `Promise#thenFinally()`
+  - `WebDriver#isElementPresent()`
+  - `WebElement#getInnerHtml()`
+  - `WebElement#getOuterHtml()`
+  - `WebElement#getRawId()`
+  - `WebElement#isElementPresent()`
 * Removed deprecated properties:
-    - `WebDriverError#code`
+  - `WebDriverError#code`
 
 ## v2.53.2
 
@@ -629,8 +624,7 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
   Marionette may be enabled via the API,
   `firefox.Options#useMarionette`, or by setting the `SELENIUM_MARIONETTE`
   environment variable.
-* Moved all logic for parsing and interpreting responses from the remote end into the
-  individual `command.Executor` implementations.
+* Moved all logic for parsing and interpreting responses from the remote end into the individual `command.Executor` implementations.
 * For consistency with the other Selenium language bindings,
   `WebDriver#isElementPresent()` and `WebElement#isElementPresent()` have been deprecated. These
   methods will be removed in v3.0. Use the findElements command to test for the presence of an
@@ -652,8 +646,7 @@ This release requires [geckodriver 0.15.0](https://github.com/mozilla/geckodrive
 * FIXED: `io.findInPath()` will no longer match against directories that have the same basename as
   the target file.
 * FIXED: `phantomjs.Driver` now takes a third argument that defines the path to a log file to use
-  for the phantomjs executable's output. This may be quickly set at runtime with
-  the `SELENIUM_PHANTOMJS_LOG` environment variable.
+  for the phantomjs executable's output. This may be quickly set at runtime with the `SELENIUM_PHANTOMJS_LOG` environment variable.
 
 ### Changes for W3C WebDriver Spec Compliance
 
@@ -691,10 +684,8 @@ the selenium-webdriver package README.
   (Map semantics). To check whether the value is true, use `get(key)`.
 * Deprecated `executors.DeferredExecutor` in favor of
   `lib/command.DeferredExecutor`.
-* API documentation is no longer distributed with the npm package, but remains available
-  at <http://seleniumhq.github.io/selenium/docs/api/javascript/>
-* Rewrote the `error` module to export an Error subtype for each type of error defined in
-  the [W3C WebDriver spec](https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors).
+* API documentation is no longer distributed with the npm package, but remains available at <http://seleniumhq.github.io/selenium/docs/api/javascript/>
+* Rewrote the `error` module to export an Error subtype for each type of error defined in the [W3C WebDriver spec](https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors).
 * Changed the `http.Request` and `http.Response` classes to store headers in maps instead of object
   literals.
 * Updated `ws` dependency to version `1.0.1`.
@@ -707,8 +698,7 @@ the selenium-webdriver package README.
 
 ### Changes for W3C WebDriver Spec Compliance
 
-* Updated the `By` locators that are not in the W3C spec to delegated to using CSS
-  selectors: `By.className`, `By.id`, `By.name`, and `By.tagName`.
+* Updated the `By` locators that are not in the W3C spec to delegated to using CSS selectors: `By.className`, `By.id`, `By.name`, and `By.tagName`.
 
 ## v2.49-51
 
@@ -732,8 +722,7 @@ the selenium-webdriver package README.
   version
   `2.1.1`.
 * FIXED: the `webdriver.promise.ControlFlow` now has a consistent execution order for
-  tasks/callbacks scheduled in different turns of the JS event loop. Refer to
-  the `webdriver.promise` documentation for more details.
+  tasks/callbacks scheduled in different turns of the JS event loop. Refer to the `webdriver.promise` documentation for more details.
 * FIXED: do not drop user auth from the WebDriver server URL.
 * FIXED: a single `firefox.Binary` instance may be used to configure and launch multiple
   FirefoxDriver sessions.
@@ -763,7 +752,7 @@ continue to be supported, but will require setting the `--harmony` flag.
 ### Change Summary
 
 * Add support for [Node v4.0.0](https://nodejs.org/en/blog/release/v4.0.0/)
-    * Updated `ws` dependency from `0.7.1` to `0.8.0`
+  * Updated `ws` dependency from `0.7.1` to `0.8.0`
 * Bumped the minimum supported version of Node from `0.10.x` to `0.12.x`. This is in accordance with
   the Node support policy established in `v2.45.0`.
 
@@ -780,14 +769,14 @@ continue to be supported, but will require setting the `--harmony` flag.
 * Added support for using a proxy server for WebDriver commands. See `Builder#usingWebDriverProxy()`
   for more info.
 * Removed deprecated functions:
-    * Capabilities#toJSON()
-    * UnhandledAlertError#getAlert()
-    * chrome.createDriver()
-    * phantomjs.createDriver()
-    * promise.ControlFlow#annotateError()
-    * promise.ControlFlow#await()
-    * promise.ControlFlow#clearHistory()
-    * promise.ControlFlow#getHistory()
+  * Capabilities#toJSON()
+  * UnhandledAlertError#getAlert()
+  * chrome.createDriver()
+  * phantomjs.createDriver()
+  * promise.ControlFlow#annotateError()
+  * promise.ControlFlow#await()
+  * promise.ControlFlow#clearHistory()
+  * promise.ControlFlow#getHistory()
 * Removed deprecated enum values: `ErrorCode.NO_MODAL_DIALOG_OPEN` and
   `ErrorCode.MODAL_DIALOG_OPENED`. Use `ErrorCode.NO_SUCH_ALERT` and
   `ErrorCode.UNEXPECTED_ALERT_OPEN`, respectively.
@@ -811,8 +800,7 @@ continue to be supported, but will require setting the `--harmony` flag.
 * FIXED: 8548: Task callbacks are once again dropped if the task was cancelled due to a previously
   uncaught error within the frame.
 * FIXED: 8496: Extended the `chrome.Options` API to cover all configuration options (e.g. mobile
-  emulation and performance logging) documented on the
-  ChromeDriver [project site](https://chromedriver.chromium.org/capabilities).
+  emulation and performance logging) documented on the ChromeDriver [project site](https://chromedriver.chromium.org/capabilities).
 
 ## v2.45.0
 
@@ -887,8 +875,7 @@ major version release (i.e. 1.0.0).
 * Expanded the interactions API to include touch actions. See `WebDriver.touchActions()`.
 * FIXED: 8380: `firefox.Driver` will delete its temporary profile on `quit`.
 * FIXED: 8306: Stack overflow in promise callbacks eliminated.
-* FIXED: 8221: Added support for defining custom command mappings. Includes support for
-  PhantomJS's `executePhantomJS` (requires PhantomJS 1.9.7 or GhostDriver 1.1.0).
+* FIXED: 8221: Added support for defining custom command mappings. Includes support for PhantomJS's `executePhantomJS` (requires PhantomJS 1.9.7 or GhostDriver 1.1.0).
 * FIXED: 8128: When the FirefoxDriver marshals an object to the page for
   `executeScript`, it defines additional properties (required by the driver's implementation). These
   properties will no longer be enumerable and should be omitted (i.e. they won't show up in
@@ -1091,14 +1078,14 @@ major version release (i.e. 1.0.0).
 * For Promises/A+ compatibility, backing out the change in 2.30.0 that ensured rejections were
   always Error objects. Rejection reasons are now left as is.
 * Removed deprecated functions originally scheduled for removal in 2.31.0
-    * promise.Application.getInstance()
-    * promise.ControlFlow#schedule()
-    * promise.ControlFlow#scheduleTimeout()
-    * promise.ControlFlow#scheduleWait()
+  * promise.Application.getInstance()
+  * promise.ControlFlow#schedule()
+  * promise.ControlFlow#scheduleTimeout()
+  * promise.ControlFlow#scheduleWait()
 * Renamed some functions for consistency with Promises/A+ terminology. The original functions have
   been deprecated and will be removed in 2.34.0:
-    * promise.resolved() -> promise.fulfilled()
-    * promise.Deferred#resolve() -> promise.Deferred#fulfill()
+  * promise.resolved() -> promise.fulfilled()
+  * promise.Deferred#resolve() -> promise.Deferred#fulfill()
 * FIXED: remote.SeleniumServer#stop now shuts down within the active control flow, allowing scripts
   to finish. Use #kill to shutdown immediately.
 * FIXED: 5321: cookie deletion commands

package/index.js

@@ -38,7 +38,6 @@ const safari = require('./safari')
 const session = require('./lib/session')
 const until = require('./lib/until')
 const webdriver = require('./lib/webdriver')
-const opera = require('./opera')
 
 const Browser = capabilities.Browser
 const Capabilities = capabilities.Capabilities
@@ -232,12 +231,6 @@ class Builder {
 
     /** @private {http.Agent} */
     this.agent_ = null
-
-    /** @private {opera.Options} */
-    this.operaOptions_ = null
-
-    /** @private {remote.DriverService.Builder} */
-    this.operaService_ = null
   }
 
   /**
@@ -432,20 +425,6 @@ class Builder {
     return this
   }
 
-  /**
-   * Sets Opera specific {@linkplain opera.Options options} for drivers
-   * created by this builder. Any logging or proxy settings defined on the given
-   * options will take precedence over those set through
-   * {@link #setLoggingPrefs} and {@link #setProxy}, respectively.
-   *
-   * @param {!opera.Options} options The OperaDriver options to use.
-   * @return {!Builder} A self reference.
-   */
-  setOperaOptions(options) {
-    this.operaOptions_ = options
-    return this
-  }
-
   /**
    * @return {chrome.Options} the Chrome specific options currently configured
    *     for this builder.
@@ -560,21 +539,6 @@ class Builder {
     return this
   }
 
-  /**
-   * Sets the {@link opera.ServiceBuilder} to use to manage the
-   * operaDriver child process when creating sessions locally.
-   *
-   * @param {opera.ServiceBuilder} service the service to use.
-   * @return {!Builder} a self reference.
-   */
-  setOperaService(service) {
-    if (service && !(service instanceof opera.ServiceBuilder)) {
-      throw TypeError('not a opera.ServiceBuilder object')
-    }
-    this.operaService_ = service
-    return this
-  }
-
   /**
    * Sets Safari specific {@linkplain safari.Options options} for drivers
    * created by this builder. Any logging settings defined on the given options
@@ -648,8 +612,6 @@ class Builder {
       capabilities.merge(this.safariOptions_)
     } else if (browser === Browser.EDGE && this.edgeOptions_) {
       capabilities.merge(this.edgeOptions_)
-    } else if (browser === Browser.OPERA && this.operaOptions_) {
-      capabilities.merge(this.operaOptions_)
     }
 
     checkOptions(
@@ -736,14 +698,6 @@ class Builder {
         return createDriver(edge.Driver, capabilities, service)
       }
 
-      case Browser.OPERA: {
-        let service = null
-        if (this.operaService_) {
-          service = this.operaService_.build()
-        }
-        return createDriver(opera.Driver, capabilities, service)
-      }
-
       case Browser.SAFARI:
         return createDriver(safari.Driver, capabilities)
 

package/lib/capabilities.js

@@ -34,7 +34,6 @@ const Browser = {
   FIREFOX: 'firefox',
   INTERNET_EXPLORER: 'internet explorer',
   SAFARI: 'safari',
-  OPERA: 'opera',
 }
 
 /**
@@ -282,13 +281,6 @@ class Capabilities {
     return new Capabilities().setBrowserName(Browser.SAFARI)
   }
 
-  /**
-   * @return {!Capabilities} A basic set of capabilities for Opera
-   */
-  static opera() {
-    return new Capabilities().setBrowserName(Browser.OPERA)
-  }
-
   /**
    * @return {!Object<string, ?>} The JSON representation of this instance.
    *     Note, the returned object may contain nested promised values.

package/lib/webdriver.js

@@ -2162,13 +2162,23 @@ class TargetLocator {
    * If the specified frame can not be found, the returned promise will be
    * rejected with a {@linkplain error.NoSuchFrameError}.
    *
-   * @param {(number|WebElement|null)} id The frame locator.
+   * @param {(number|string|WebElement|null)} id The frame locator.
    * @return {!Promise<void>} A promise that will be resolved
    *     when the driver has changed focus to the specified frame.
    */
   frame(id) {
+    let frameReference = id
+    if (typeof id === 'string') {
+      frameReference = this.driver_
+        .findElement({ id })
+        .catch((_) => this.driver_.findElement({ name: id }))
+    }
+
     return this.driver_.execute(
-      new command.Command(command.Name.SWITCH_TO_FRAME).setParameter('id', id)
+      new command.Command(command.Name.SWITCH_TO_FRAME).setParameter(
+        'id',
+        frameReference
+      )
     )
   }
 
@@ -2755,13 +2765,17 @@ class WebElement {
    *     when the form has been submitted.
    */
   submit() {
-    const form = this.findElement({ xpath: './ancestor-or-self::form' })
-    this.driver_.executeScript(
-      "var e = arguments[0].ownerDocument.createEvent('Event');" +
-        "e.initEvent('submit', true, true);" +
-        'if (arguments[0].dispatchEvent(e)) { arguments[0].submit() }',
-      form
-    )
+    const script = "var form = arguments[0];\n" +
+      "while (form.nodeName != \"FORM\" && form.parentNode) {\n" +
+      "  form = form.parentNode;\n" +
+      "}\n" +
+      "if (!form) { throw Error('Unable to find containing form element'); }\n" +
+      "if (!form.ownerDocument) { throw Error('Unable to find owning document'); }\n" +
+      "var e = form.ownerDocument.createEvent('Event');\n" +
+      "e.initEvent('submit', true, true);\n" +
+      "if (form.dispatchEvent(e)) { HTMLFormElement.prototype.submit.call(form) }\n";
+
+    this.driver_.executeScript(script, this);
   }
 
   /**

package/net/index.js

@@ -48,7 +48,7 @@ function getIPAddress(loopback, family) {
     }
 
     for (let ipAddress of interfaces[key]) {
-      if (ipAddress.family === family && ipAddress.internal === loopback) {
+      if ((ipAddress.family === family || `IPv${ipAddress.family}` === family) && ipAddress.internal === loopback) {
         return ipAddress.address
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.1.2",
+  "version": "4.2.0",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [

package/testing/index.js

@@ -39,7 +39,6 @@ const firefox = require('../firefox')
 const ie = require('../ie')
 const remote = require('../remote')
 const safari = require('../safari')
-const opera = require('../opera')
 const { Browser, Capabilities } = require('../lib/capabilities')
 const { Builder } = require('../index')
 
@@ -47,7 +46,7 @@ const { Builder } = require('../index')
  * Describes a browser targeted by a {@linkplain suite test suite}.
  * @record
  */
-function TargetBrowser() {}
+function TargetBrowser() { }
 
 /**
  * The {@linkplain Browser name} of the targeted browser.
@@ -123,7 +122,6 @@ function getAvailableBrowsers() {
     [firefox.locateSynchronously, Browser.FIREFOX],
     [ie.locateSynchronously, Browser.INTERNET_EXPLORER],
     [safari.locateSynchronously, Browser.SAFARI],
-    [opera.locateSynchronously, Browser.OPERA],
   ]
 
   let availableBrowsers = []
@@ -210,7 +208,7 @@ function init(force = false) {
   if (seleniumJar && seleniumUrl) {
     throw Error(
       'Ambiguous test configuration: both SELENIUM_REMOTE_URL' +
-        ' && SELENIUM_SERVER_JAR environment variables are set'
+      ' && SELENIUM_SERVER_JAR environment variables are set'
     )
   }
 
@@ -218,8 +216,8 @@ function init(force = false) {
   if ((seleniumJar || seleniumUrl) && envBrowsers.length === 0) {
     throw Error(
       'Ambiguous test configuration: when either the SELENIUM_REMOTE_URL or' +
-        ' SELENIUM_SERVER_JAR environment variable is set, the' +
-        ' SELENIUM_BROWSER variable must also be set.'
+      ' SELENIUM_SERVER_JAR environment variable is set, the' +
+      ' SELENIUM_BROWSER variable must also be set.'
     )
   }
 
@@ -297,7 +295,7 @@ class Environment {
         builder.getCapabilities().merge(browser.capabilities);
       }
 
-      if(browser.name === 'firefox') {
+      if (browser.name === 'firefox') {
         builder.setCapability('moz:debuggerAddress', true);
       }
 
@@ -317,7 +315,7 @@ class Environment {
  * Configuration options for a {@linkplain ./index.suite test suite}.
  * @record
  */
-function SuiteOptions() {}
+function SuiteOptions() { }
 
 /**
  * The browsers to run the test suite against.
@@ -492,8 +490,8 @@ function getTestHook(name) {
   if (type !== 'function') {
     throw TypeError(
       `Expected global.${name} to be a function, but is ${type}.` +
-        ' This can happen if you try using this module when running with' +
-        ' node directly instead of using jasmine or mocha'
+      ' This can happen if you try using this module when running with' +
+      ' node directly instead of using jasmine or mocha'
     )
   }
   return fn

package/opera.js

@@ -1,403 +0,0 @@
-// Licensed to the Software Freedom Conservancy (SFC) under one
-// or more contributor license agreements.  See the NOTICE file
-// distributed with this work for additional information
-// regarding copyright ownership.  The SFC licenses this file
-// to you under the Apache License, Version 2.0 (the
-// "License"); you may not use this file except in compliance
-// with the License.  You may obtain a copy of the License at
-//
-//   http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing,
-// software distributed under the License is distributed on an
-// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-// KIND, either express or implied.  See the License for the
-// specific language governing permissions and limitations
-// under the License.
-
-/**
- * @fileoverview Defines a {@linkplain Driver WebDriver} client for the
- * Opera web browser (v26+). Before using this module, you must download the
- * latest OperaDriver
- * [release](https://github.com/operasoftware/operachromiumdriver/releases) and
- * ensure it can be found on your system
- * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29).
- *
- * There are three primary classes exported by this module:
- *
- * 1. {@linkplain ServiceBuilder}: configures the
- *     {@link ./remote.DriverService remote.DriverService}
- *     that manages the
- *     [OperaDriver](https://github.com/operasoftware/operachromiumdriver)
- *     child process.
- *
- * 2. {@linkplain Options}: defines configuration options for each new Opera
- *     session, such as which {@linkplain Options#setProxy proxy} to use,
- *     what {@linkplain Options#addExtensions extensions} to install, or
- *     what {@linkplain Options#addArguments command-line switches} to use when
- *     starting the browser.Service
- *
- * 3. {@linkplain Driver}: the WebDriver client; each new instance will control
- *     a unique browser session with a clean user profile (unless otherwise
- *     configured through the {@link Options} class).
- *
- * By default, every Opera session will use a single driver service, which is
- * started the first time a {@link Driver} instance is created and terminated
- * when this process exits. The default service will inherit its environment
- * from the current process and direct all output to /dev/null. You may obtain
- * a handle to this default service using
- * {@link #getDefaultService getDefaultService()} and change its configuration
- * with {@link #setDefaultService setDefaultService()}.
- *
- * You may also create a {@link Driver} with its own driver service. This is
- * useful if you need to capture the server's log output for a specific session:
- *
- *     var opera = require('selenium-webdriver/opera');
- *
- *     var service = new opera.ServiceBuilder()
- *         .loggingTo('/my/log/file.txt')
- *         .enableVerboseLogging()
- *         .build();
- *
- *     var options = new opera.Options();
- *     // configure browser options ...
- *
- *     var driver = opera.Driver.createSession(options, service);
- *
- * Users should only instantiate the {@link Driver} class directly when they
- * need a custom driver service configuration (as shown above). For normal
- * operation, users should start Opera using the
- * {@link ./builder.Builder selenium-webdriver.Builder}.
- */
-
-'use strict'
-
-const http = require('./http')
-const io = require('./io')
-const capabilities = require('./lib/capabilities')
-const Symbols = require('./lib/symbols')
-const webdriver = require('./lib/webdriver')
-const remote = require('./remote')
-
-/**
- * Name of the OperaDriver executable.
- * @type {string}
- * @const
- */
-const OPERADRIVER_EXE =
-  process.platform === 'win32' ? 'operadriver.exe' : 'operadriver'
-
-/**
- * _Synchronously_ attempts to locate the operadriver executable on the current
- * system.
- *
- * @return {?string} the located executable, or `null`.
- */
-function locateSynchronously() {
-  return io.findInPath(OPERADRIVER_EXE, true)
-}
-
-/**
- * Creates {@link remote.DriverService} instances that manages an
- * [OperaDriver](https://github.com/operasoftware/operachromiumdriver)
- * server in a child process.
- */
-class ServiceBuilder extends remote.DriverService.Builder {
-  /**
-   * @param {string=} opt_exe Path to the server executable to use. If omitted,
-   *     the builder will attempt to locate the operadriver on the current
-   *     PATH.
-   * @throws {Error} If provided executable does not exist, or the operadriver
-   *     cannot be found on the PATH.
-   */
-  constructor(opt_exe) {
-    let exe = opt_exe || locateSynchronously()
-    if (!exe) {
-      throw Error(
-        'The OperaDriver could not be found on the current PATH. Please ' +
-          'download the latest version of the OperaDriver from ' +
-          'https://github.com/operasoftware/operachromiumdriver/releases and ' +
-          'ensure it can be found on your PATH.'
-      )
-    }
-
-    super(exe)
-    this.setLoopback(true)
-  }
-
-  /**
-   * Sets the path of the log file the driver should log to. If a log file is
-   * not specified, the driver will log to stderr.
-   * @param {string} path Path of the log file to use.
-   * @return {!ServiceBuilder} A self reference.
-   */
-  loggingTo(path) {
-    return this.addArguments('--log-path=' + path)
-  }
-
-  /**
-   * Enables verbose logging.
-   * @return {!ServiceBuilder} A self reference.
-   */
-  enableVerboseLogging() {
-    return this.addArguments('--verbose')
-  }
-
-  /**
-   * Silence sthe drivers output.
-   * @return {!ServiceBuilder} A self reference.
-   */
-  silent() {
-    return this.addArguments('--silent')
-  }
-}
-
-/** @type {remote.DriverService} */
-let defaultService = null
-
-/**
- * Sets the default service to use for new OperaDriver instances.
- * @param {!remote.DriverService} service The service to use.
- * @throws {Error} If the default service is currently running.
- */
-function setDefaultService(service) {
-  if (defaultService && defaultService.isRunning()) {
-    throw Error(
-      'The previously configured OperaDriver service is still running. ' +
-        'You must shut it down before you may adjust its configuration.'
-    )
-  }
-  defaultService = service
-}
-
-/**
- * Returns the default OperaDriver service. If such a service has not been
- * configured, one will be constructed using the default configuration for
- * a OperaDriver executable found on the system PATH.
- * @return {!remote.DriverService} The default OperaDriver service.
- */
-function getDefaultService() {
-  if (!defaultService) {
-    defaultService = new ServiceBuilder().build()
-  }
-  return defaultService
-}
-
-/**
- * @type {string}
- * @const
- */
-const OPTIONS_CAPABILITY_KEY = 'chromeOptions'
-
-/**
- * Class for managing {@linkplain Driver OperaDriver} specific options.
- */
-class Options {
-  constructor() {
-    /** @private {!Array.<string>} */
-    this.args_ = []
-
-    /** @private {?string} */
-    this.binary_ = null
-
-    /** @private {!Array.<(string|!Buffer)>} */
-    this.extensions_ = []
-
-    /** @private {./lib/logging.Preferences} */
-    this.logPrefs_ = null
-
-    /** @private {?capabilities.ProxyConfig} */
-    this.proxy_ = null
-  }
-
-  /**
-   * Extracts the OperaDriver specific options from the given capabilities
-   * object.
-   * @param {!capabilities.Capabilities} caps The capabilities object.
-   * @return {!Options} The OperaDriver options.
-   */
-  static fromCapabilities(caps) {
-    let options
-    const o = caps.get(OPTIONS_CAPABILITY_KEY)
-    if (o instanceof Options) {
-      options = o
-    } else if (o) {
-      options = new Options()
-        .addArguments(o.args || [])
-        .addExtensions(o.extensions || [])
-        .setOperaBinaryPath(o.binary)
-    } else {
-      options = new Options()
-    }
-
-    if (caps.has(capabilities.Capability.PROXY)) {
-      options.setProxy(caps.get(capabilities.Capability.PROXY))
-    }
-
-    if (caps.has(capabilities.Capability.LOGGING_PREFS)) {
-      options.setLoggingPrefs(caps.get(capabilities.Capability.LOGGING_PREFS))
-    }
-
-    return options
-  }
-
-  /**
-   * Add additional command line arguments to use when launching the Opera
-   * browser.  Each argument may be specified with or without the "--" prefix
-   * (e.g. "--foo" and "foo"). Arguments with an associated value should be
-   * delimited by an "=": "foo=bar".
-   * @param {...(string|!Array.<string>)} var_args The arguments to add.
-   * @return {!Options} A self reference.
-   */
-  addArguments(...var_args) {
-    this.args_ = this.args_.concat.apply(this.args_, var_args)
-    return this
-  }
-
-  /**
-   * Add additional extensions to install when launching Opera. Each extension
-   * should be specified as the path to the packed CRX file, or a Buffer for an
-   * extension.
-   * @param {...(string|!Buffer|!Array.<(string|!Buffer)>)} var_args The
-   *     extensions to add.
-   * @return {!Options} A self reference.
-   */
-  addExtensions(...var_args) {
-    this.extensions_ = this.extensions_.concat.apply(this.extensions_, var_args)
-    return this
-  }
-
-  /**
-   * Sets the path to the Opera binary to use. On Mac OS X, this path should
-   * reference the actual Opera executable, not just the application binary. The
-   * binary path be absolute or relative to the operadriver server executable, but
-   * it must exist on the machine that will launch Opera.
-   *
-   * @param {string} path The path to the Opera binary to use.
-   * @return {!Options} A self reference.
-   */
-  setOperaBinaryPath(path) {
-    this.binary_ = path
-    return this
-  }
-
-  /**
-   * Sets the logging preferences for the new session.
-   * @param {!./lib/logging.Preferences} prefs The logging preferences.
-   * @return {!Options} A self reference.
-   */
-  setLoggingPrefs(prefs) {
-    this.logPrefs_ = prefs
-    return this
-  }
-
-  /**
-   * Sets the proxy settings for the new session.
-   * @param {capabilities.ProxyConfig} proxy The proxy configuration to use.
-   * @return {!Options} A self reference.
-   */
-  setProxy(proxy) {
-    this.proxy_ = proxy
-    return this
-  }
-
-  /**
-   * Converts this options instance to a {@link capabilities.Capabilities}
-   *     object.
-   * @param {capabilities.Capabilities=} opt_capabilities The capabilities to
-   *     merge these options into, if any.
-   * @return {!capabilities.Capabilities} The capabilities.
-   */
-  toCapabilities(opt_capabilities) {
-    var caps = opt_capabilities || capabilities.Capabilities.opera()
-    caps
-      .set(capabilities.Capability.PROXY, this.proxy_)
-      .set(capabilities.Capability.LOGGING_PREFS, this.logPrefs_)
-      .set(OPTIONS_CAPABILITY_KEY, this)
-    return caps
-  }
-
-  /**
-   * Converts this instance to its JSON wire protocol representation. Note this
-   * function is an implementation not intended for general use.
-   * @return {!Object} The JSON wire protocol representation of this instance.
-   */
-  [Symbols.serialize]() {
-    var json = {
-      args: this.args_,
-      extensions: this.extensions_.map(function (extension) {
-        if (Buffer.isBuffer(extension)) {
-          return extension.toString('base64')
-        }
-        return io
-          .read(/** @type {string} */ (extension))
-          .then((buffer) => buffer.toString('base64'))
-      }),
-    }
-    if (this.binary_) {
-      json.binary = this.binary_
-    }
-    return json
-  }
-}
-
-/**
- * Creates a new WebDriver client for Opera.
- */
-class Driver extends webdriver.WebDriver {
-  /**
-   * Creates a new session for Opera.
-   *
-   * @param {(Capabilities|Options)=} opt_config The configuration
-   *     options.
-   * @param {remote.DriverService=} opt_service The session to use; will use
-   *     the {@link getDefaultService default service} by default.
-   * @return {!Driver} A new driver instance.
-   */
-  static createSession(opt_config, opt_service) {
-    const service = opt_service || getDefaultService()
-    const client = service.start().then((url) => new http.HttpClient(url))
-    const executor = new http.Executor(client)
-
-    let caps =
-      opt_config instanceof Options
-        ? opt_config.toCapabilities()
-        : opt_config || capabilities.Capabilities.opera()
-
-    // On Linux, the OperaDriver does not look for Opera on the PATH, so we
-    // must explicitly find it. See: operachromiumdriver #9.
-    if (process.platform === 'linux') {
-      const options = Options.fromCapabilities(caps)
-      if (!options.binary_) {
-        let exe = io.findInPath('opera', true)
-        if (!exe) {
-          throw Error(
-            'The opera executable could not be found on the current PATH'
-          )
-        }
-        options.setOperaBinaryPath(exe)
-      }
-      caps = options.toCapabilities(caps)
-    }
-
-    return /** @type {!Driver} */ (
-      super.createSession(executor, caps, () => service.kill())
-    )
-  }
-
-  /**
-   * This function is a no-op as file detectors are not supported by this
-   * implementation.
-   * @override
-   */
-  setFileDetector() {}
-}
-
-// PUBLIC API
-
-exports.Driver = Driver
-exports.Options = Options
-exports.ServiceBuilder = ServiceBuilder
-exports.getDefaultService = getDefaultService
-exports.setDefaultService = setDefaultService
-exports.locateSynchronously = locateSynchronously