selenium-webdriver 4.1.2 → 4.3.1

package/chrome.js

@@ -140,7 +140,6 @@ const CHROMEDRIVER_EXE =
   process.platform === 'win32' ? 'chromedriver.exe' : 'chromedriver'
 
 /** @type {remote.DriverService} */
-let defaultService = null
 
 /**
  * Creates {@link selenium-webdriver/remote.DriverService} instances that manage
@@ -240,6 +239,14 @@ class Driver extends chromium.Driver {
       super.createSession(caps, opt_serviceExecutor)
     )
   }
+
+  /**
+   * returns new instance chrome driver service
+   * @returns {remote.DriverService}
+   */
+  static getDefaultService() {
+    return new ServiceBuilder().build()
+  }
 }
 
 /**
@@ -252,47 +259,14 @@ function locateSynchronously() {
   return io.findInPath(CHROMEDRIVER_EXE, true)
 }
 
-/**
- * Sets the default service to use for new ChromeDriver 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 ChromeDriver service is still running. ` +
-        `You must shut it down before you may adjust its configuration.`
-    )
-  }
-  defaultService = service
-}
-
-/**
- * Returns the default ChromeDriver service. If such a service has not been
- * configured, one will be constructed using the default configuration for
- * a ChromeDriver executable found on the system PATH.
- * @return {!remote.DriverService} The default ChromeDriver service.
- */
-function getDefaultService() {
-  if (!defaultService) {
-    defaultService = new ServiceBuilder().build()
-  }
-  return defaultService
-}
-
 Options.prototype.CAPABILITY_KEY = 'goog:chromeOptions'
 Options.prototype.BROWSER_NAME_VALUE = Browser.CHROME
-Driver.getDefaultService = getDefaultService
 Driver.prototype.VENDOR_COMMAND_PREFIX = 'goog'
 
 // PUBLIC API
-
 module.exports = {
   Driver: Driver,
   Options,
-  ServiceBuilder ,
-  getDefaultService,
-  setDefaultService,
-  locateSynchronously
+  ServiceBuilder,
+  locateSynchronously,
 }
-

package/chromium.js

@@ -661,11 +661,13 @@ class Driver extends webdriver.WebDriver {
    */
   static createSession(caps, opt_serviceExecutor) {
     let executor
+    let onQuit
     if (opt_serviceExecutor instanceof http.Executor) {
       executor = opt_serviceExecutor
       configureExecutor(executor, this.VENDOR_COMMAND_PREFIX)
     } else {
       let service = opt_serviceExecutor || this.getDefaultService()
+      onQuit = () => service.kill()
       executor = createExecutor(service.start(), this.VENDOR_COMMAND_PREFIX)
     }
 
@@ -679,7 +681,7 @@ class Driver extends webdriver.WebDriver {
       }
     }
 
-    return /** @type {!Driver} */ (super.createSession(executor, caps))
+    return /** @type {!Driver} */ (super.createSession(executor, caps, onQuit))
   }
 
   /**
@@ -860,7 +862,7 @@ class Driver extends webdriver.WebDriver {
    * @return {!promise.Thenable<void>} A promise that will be resolved
    *     when the mirror command has been issued to the device.
    */
-   startDesktopMirroring(deviceName) {
+  startDesktopMirroring(deviceName) {
     return this.schedule(
       new command.Command(Command.START_CAST_DESKTOP_MIRRORING).setParameter(
         'sinkName',

package/devtools/CDPConnection.js

@@ -19,7 +19,7 @@ class CDPConnection {
   constructor(wsConnection) {
     this._wsConnection = wsConnection
     this.cmd_id = 0
-    this.targetID = null;
+    this.targetID = null
     this.sessionId = null
   }
 

package/edge.js

@@ -90,7 +90,6 @@ const EDGEDRIVER_CHROMIUM_EXE =
   process.platform === 'win32' ? 'msedgedriver.exe' : 'msedgedriver'
 
 /** @type {remote.DriverService} */
-let defaultService = null
 
 /**
  * Creates {@link selenium-webdriver/remote.DriverService} instances that manage
@@ -157,6 +156,14 @@ class Driver extends chromium.Driver {
     )
   }
 
+  /**
+   * returns new instance of edge driver service
+   * @returns {remote.DriverService}
+   */
+  static getDefaultService() {
+    return new ServiceBuilder().build()
+  }
+
   /**
    * This function is a no-op as file detectors are not supported by this
    * implementation.
@@ -165,34 +172,6 @@ class Driver extends chromium.Driver {
   setFileDetector() {}
 }
 
-/**
- * Sets the default service to use for new Edge 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 EdgeDriver service is still running. ' +
-        'You must shut it down before you may adjust its configuration.'
-    )
-  }
-  defaultService = service
-}
-
-/**
- * Returns the default Microsoft Edge driver service. If such a service has
- * not been configured, one will be constructed using the default configuration
- * for a MicrosoftWebDriver executable found on the system PATH.
- * @return {!remote.DriverService} The default Microsoft Edge driver service.
- */
-function getDefaultService() {
-  if (!defaultService) {
-    defaultService = new ServiceBuilder().build()
-  }
-  return defaultService
-}
-
 /**
  * _Synchronously_ attempts to locate the chromedriver executable on the current
  * system.
@@ -206,7 +185,6 @@ function locateSynchronously() {
 Options.prototype.BROWSER_NAME_VALUE = Browser.EDGE
 Options.prototype.CAPABILITY_KEY = 'ms:edgeOptions'
 Driver.prototype.VENDOR_CAPABILITY_PREFIX = 'ms'
-Driver.getDefaultService = getDefaultService
 
 // PUBLIC API
 
@@ -214,7 +192,5 @@ module.exports = {
   Driver,
   Options,
   ServiceBuilder,
-  getDefaultService,
-  setDefaultService,
   locateSynchronously,
 }

package/firefox.js

@@ -672,7 +672,7 @@ class Driver extends webdriver.WebDriver {
    */
   async installAddon(path, temporary = false) {
     let stats = fs.statSync(path)
-    let buf;
+    let buf
     if (stats.isDirectory()) {
       let zip = new Zip()
       await zip.addDir(path)

package/ie.js

@@ -402,9 +402,9 @@ function createServiceFromCapabilities(capabilities) {
   if (!exe || !fs.existsSync(exe)) {
     throw Error(
       `${IEDRIVER_EXE} could not be found on the current PATH. Please ` +
-      `download the latest version of ${IEDRIVER_EXE} from ` +
-      'https://www.selenium.dev/downloads/ and ' +
-      'ensure it can be found on your system PATH.'
+        `download the latest version of ${IEDRIVER_EXE} from ` +
+        'https://www.selenium.dev/downloads/ and ' +
+        'ensure it can be found on your system PATH.'
     )
   }
 

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
@@ -78,7 +77,7 @@ function startSeleniumServer(jar) {
 function ensureFileDetectorsAreEnabled(ctor) {
   return class extends ctor {
     /** @param {input.FileDetector} detector */
-    setFileDetector (detector) {
+    setFileDetector(detector) {
       webdriver.WebDriver.prototype.setFileDetector.call(this, detector)
     }
   }
@@ -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/command.js

@@ -164,6 +164,15 @@ const Name = {
   FIND_ELEMENT_FROM_SHADOWROOT: 'findElementFromShadowRoot',
   FIND_ELEMENTS_FROM_SHADOWROOT: 'findElementsFromShadowRoot',
 
+  // Virtual Authenticator Commands
+  ADD_VIRTUAL_AUTHENTICATOR: 'addVirtualAuthenticator',
+  REMOVE_VIRTUAL_AUTHENTICATOR: 'removeVirtualAuthenticator',
+  ADD_CREDENTIAL: 'addCredential',
+  GET_CREDENTIALS: 'getCredentials',
+  REMOVE_CREDENTIAL: 'removeCredential',
+  REMOVE_ALL_CREDENTIALS: 'removeAllCredentials',
+  SET_USER_VERIFIED: 'setUserVerified',
+
   GET_AVAILABLE_LOG_TYPES: 'getAvailableLogTypes',
   GET_LOG: 'getLog',
 

package/lib/http.js

@@ -347,6 +347,44 @@ const W3C_COMMAND_MAP = new Map([
 
   // Server Extensions
   [cmd.Name.UPLOAD_FILE, post('/session/:sessionId/se/file')],
+
+  // Virtual Authenticator
+  [
+    cmd.Name.ADD_VIRTUAL_AUTHENTICATOR,
+    post('/session/:sessionId/webauthn/authenticator'),
+  ],
+  [
+    cmd.Name.REMOVE_VIRTUAL_AUTHENTICATOR,
+    del('/session/:sessionId/webauthn/authenticator/:authenticatorId'),
+  ],
+  [
+    cmd.Name.ADD_CREDENTIAL,
+    post(
+      '/session/:sessionId/webauthn/authenticator/:authenticatorId/credential'
+    ),
+  ],
+  [
+    cmd.Name.GET_CREDENTIALS,
+    get(
+      '/session/:sessionId/webauthn/authenticator/:authenticatorId/credentials'
+    ),
+  ],
+  [
+    cmd.Name.REMOVE_CREDENTIAL,
+    del(
+      '/session/:sessionId/webauthn/authenticator/:authenticatorId/credentials/:credentialId'
+    ),
+  ],
+  [
+    cmd.Name.REMOVE_ALL_CREDENTIALS,
+    del(
+      '/session/:sessionId/webauthn/authenticator/:authenticatorId/credentials'
+    ),
+  ],
+  [
+    cmd.Name.SET_USER_VERIFIED,
+    post('/session/:sessionId/webauthn/authenticator/:authenticatorId/uv'),
+  ],
 ])
 
 /**
@@ -472,6 +510,7 @@ class Executor {
     this.log_.finer(() => `>>>\n${request}\n<<<\n${response}`)
 
     let httpResponse = /** @type {!Response} */ (response)
+
     let { isW3C, value } = parseHttpResponse(command, httpResponse)
 
     if (command.getName() === cmd.Name.NEW_SESSION) {
@@ -530,6 +569,7 @@ function parseHttpResponse(command, httpResponse) {
   }
 
   let parsed = tryParse(httpResponse.body)
+
   if (parsed && typeof parsed === 'object') {
     let value = parsed.value
     let isW3C =

package/lib/input.js

@@ -346,16 +346,42 @@ class Pointer extends Device {
 
   /**
    * @param {!Button=} button The button to press.
+   * @param width
+   * @param height
+   * @param pressure
+   * @param tangentialPressure
+   * @param tiltX
+   * @param tiltY
+   * @param twist
+   * @param altitudeAngle
+   * @param azimuthAngle
    * @return {!Action} An action to press the specified button with this device.
    * @package
    */
-  press(button = Button.LEFT, width = 0, height = 0, pressure = 0,
-    tangentialPressure = 0, tiltX = 0, tiltY = 0, twist = 0,
-    altitudeAngle = 0, azimuthAngle = 0) {
+  press(
+    button = Button.LEFT,
+    width = 0,
+    height = 0,
+    pressure = 0,
+    tangentialPressure = 0,
+    tiltX = 0,
+    tiltY = 0,
+    twist = 0,
+    altitudeAngle = 0,
+    azimuthAngle = 0
+  ) {
     return {
-      type: Action.Type.POINTER_DOWN, button, width, height,
-      pressure, tangentialPressure, tiltX, tiltY, twist,
-      altitudeAngle, azimuthAngle
+      type: Action.Type.POINTER_DOWN,
+      button,
+      width,
+      height,
+      pressure,
+      tangentialPressure,
+      tiltX,
+      tiltY,
+      twist,
+      altitudeAngle,
+      azimuthAngle,
     }
   }
 
@@ -385,15 +411,36 @@ class Pointer extends Device {
    * @return {!Action} The new action.
    * @package
    */
-  move({ x = 0, y = 0, duration = 100, origin = Origin.VIEWPORT,
-    width = 0, height = 0, pressure = 0,
-    tangentialPressure = 0, tiltX = 0, tiltY = 0, twist = 0,
-    altitudeAngle = 0, azimuthAngle = 0
+  move({
+    x = 0,
+    y = 0,
+    duration = 100,
+    origin = Origin.VIEWPORT,
+    width = 0,
+    height = 0,
+    pressure = 0,
+    tangentialPressure = 0,
+    tiltX = 0,
+    tiltY = 0,
+    twist = 0,
+    altitudeAngle = 0,
+    azimuthAngle = 0,
   }) {
     return {
-      type: Action.Type.POINTER_MOVE, origin, duration, x, y,
-      width, height, pressure, tangentialPressure, tiltX, tiltY, twist,
-      altitudeAngle, azimuthAngle
+      type: Action.Type.POINTER_MOVE,
+      origin,
+      duration,
+      x,
+      y,
+      width,
+      height,
+      pressure,
+      tangentialPressure,
+      tiltX,
+      tiltY,
+      twist,
+      altitudeAngle,
+      azimuthAngle,
     }
   }
 }
@@ -410,10 +457,9 @@ Pointer.Type = {
 
 class Wheel extends Device {
   /**
-   * @param {string} id the device ID.
-   * @param {Pointer.Type} type the pointer type.
+   * @param {string} id the device ID..
    */
-  constructor(id, type) {
+  constructor(id) {
     super(Device.Type.WHEEL, id)
   }
 
@@ -423,15 +469,19 @@ class Wheel extends Device {
    * @param {number} y starting y coordinate
    * @param {number} deltaX Delta X to scroll to target
    * @param {number} deltaY Delta Y to scroll to target
+   * @param {WebElement} origin element origin
    * @param {number} duration duration ratio be the ratio of time delta and duration
    * @returns {!Action} An action to scroll with this device.
    */
   scroll(x, y, deltaX, deltaY, origin, duration) {
     return {
       type: Action.Type.SCROLL,
-      duration: duration, x: x, y: y,
-      deltaX: deltaX, deltaY: deltaY,
-      origin: origin
+      duration: duration,
+      x: x,
+      y: y,
+      deltaX: deltaX,
+      deltaY: deltaY,
+      origin: origin,
     }
   }
 }
@@ -795,18 +845,21 @@ class Actions {
    * @param {number} deltax delta x to scroll to target
    * @param {number} deltay delta y to scroll to target
    * @param {number} duration duration ratio be the ratio of time delta and duration
-   * @returns {!Action} An action to scroll with this device.
+   * @returns {!Actions} An action to scroll with this device.
    */
   scroll(x, y, targetDeltaX, targetDeltaY, origin, duration) {
-    return this.insert(this.wheel_, this.wheel_.scroll(x, y, targetDeltaX, targetDeltaY, origin, duration))
+    return this.insert(
+      this.wheel_,
+      this.wheel_.scroll(x, y, targetDeltaX, targetDeltaY, origin, duration)
+    )
   }
 
   /**
    * Inserts an action for moving the mouse `x` and `y` pixels relative to the
    * specified `origin`. The `origin` may be defined as the mouse's
-   * {@linkplain ./input.Origin.POINTER current position}, the
+   * {@linkplain ./input.Origin.POINTER current position}, the top-left corner of the
    * {@linkplain ./input.Origin.VIEWPORT viewport}, or the center of a specific
-   * {@linkplain ./webdriver.WebElement WebElement}.
+   * {@linkplain ./webdriver.WebElement WebElement}. Default is top left corner of the view-port if origin is not specified
    *
    * You may adjust how long the remote end should take, in milliseconds, to
    * perform the move using the `duration` parameter (defaults to 100 ms).