selenium-webdriver 4.48.0 → 4.50.0

package/chromium.js

@@ -506,7 +506,7 @@ class Options extends Capabilities {
    * __Example 1: Using a Pre-configured Device__
    *
    *     let options = new chrome.Options().setMobileEmulation(
-   *         {deviceName: 'Google Nexus 5'});
+   *         {deviceName: 'Pixel 10'});
    *
    *     let driver = chrome.Driver.createSession(options);
    *

package/common/seleniumManager.js

@@ -21,7 +21,7 @@
  *  Wrapper for getting information from the Selenium Manager binaries
  */
 
-const { platform } = require('node:process')
+const { platform, arch } = require('node:process')
 const path = require('node:path')
 const fs = require('node:fs')
 const spawnSync = require('node:child_process').spawnSync
@@ -39,7 +39,7 @@ function getBinary() {
     darwin: 'macos',
     win32: 'windows',
     cygwin: 'windows',
-    linux: 'linux',
+    linux: arch === 'arm64' ? 'linux-arm64' : 'linux-x86_64',
   }[platform]
 
   const file = directory === 'windows' ? 'selenium-manager.exe' : 'selenium-manager'

package/eslint.config.js

@@ -20,7 +20,8 @@ const noOnlyTests = require('eslint-plugin-no-only-tests')
 const js = require('@eslint/js')
 const eslintPluginPrettierRecommended = require('eslint-plugin-prettier/recommended')
 const mochaPlugin = require('eslint-plugin-mocha').default
-const nodePlugin = require('eslint-plugin-n').default
+// eslint-plugin-n 18 is an ES module; require() returns its 'module.exports' export, which has no .default.
+const nodePlugin = require('eslint-plugin-n')
 
 module.exports = [
   js.configs.recommended,

package/example/chrome_mobile_emulation.js

@@ -30,7 +30,7 @@ const { Options } = require('../chrome')
   try {
     driver = await new Builder()
       .forBrowser('chrome')
-      .setChromeOptions(new Options().setMobileEmulation({ deviceName: 'Nexus 5X' }))
+      .setChromeOptions(new Options().setMobileEmulation({ deviceName: 'Pixel 10' }))
       .build()
     await driver.get('http://www.google.com/ncr')
     await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)

package/firefox.js

@@ -27,15 +27,13 @@
  * __Customizing the Firefox Profile__
  *
  * The profile used for each WebDriver session may be configured using the
- * {@linkplain Options} class. For example, you may install an extension, like
- * Firebug:
+ * {@linkplain Options} class. For example, you may set a preference:
  *
  *     const {Builder} = require('selenium-webdriver');
  *     const firefox = require('selenium-webdriver/firefox');
  *
  *     let options = new firefox.Options()
- *         .addExtensions('/path/to/firebug.xpi')
- *         .setPreference('extensions.firebug.showChromeErrors', true);
+ *         .setPreference('browser.download.folderList', 2);
  *
  *     let driver = new Builder()
  *         .forBrowser('firefox')
@@ -117,81 +115,16 @@ const http = require('./http')
 const io = require('./io')
 const remote = require('./remote')
 const webdriver = require('./lib/webdriver')
-const zip = require('./io/zip')
 const { Browser, Capabilities, Capability } = require('./lib/capabilities')
 const { Zip } = require('./io/zip')
 const { getBinaryPaths } = require('./common/driverFinder')
 const { findFreePort } = require('./net/portprober')
 const FIREFOX_CAPABILITY_KEY = 'moz:firefoxOptions'
 
-/**
- * Thrown when there an add-on is malformed.
- * @final
- */
-class AddonFormatError extends Error {
-  /** @param {string} msg The error message. */
-  constructor(msg) {
-    super(msg)
-    /** @override */
-    this.name = this.constructor.name
-  }
-}
-
-/**
- * Installs an extension to the given directory.
- * @param {string} extension Path to the xpi extension file to install.
- * @param {string} dir Path to the directory to install the extension in.
- * @return {!Promise<string>} A promise for the add-on ID once
- *     installed.
- */
-async function installExtension(extension, dir) {
-  const ext = extension.slice(-4)
-  if (ext !== '.xpi' && ext !== '.zip') {
-    throw Error('File name does not end in ".zip" or ".xpi": ' + ext)
-  }
-
-  let archive = await zip.load(extension)
-  if (!archive.has('manifest.json')) {
-    throw new AddonFormatError(`Couldn't find manifest.json in ${extension}`)
-  }
-
-  let buf = await archive.getFile('manifest.json')
-  let parsedJSON = JSON.parse(buf.toString('utf8'))
-
-  let { browser_specific_settings } =
-    /** @type {{browser_specific_settings:{gecko:{id:string}}}} */
-    parsedJSON
-
-  if (browser_specific_settings && browser_specific_settings.gecko) {
-    /* browser_specific_settings is an alternative to applications
-     * It is meant to facilitate cross-browser plugins since Firefox48
-     * see https://bugzilla.mozilla.org/show_bug.cgi?id=1262005
-     */
-    parsedJSON.applications = browser_specific_settings
-  }
-
-  let { applications } =
-    /** @type {{applications:{gecko:{id:string}}}} */
-    parsedJSON
-  if (!(applications && applications.gecko && applications.gecko.id)) {
-    throw new AddonFormatError(`Could not find add-on ID for ${extension}`)
-  }
-
-  await io.copy(extension, `${path.join(dir, applications.gecko.id)}.xpi`)
-  return applications.gecko.id
-}
-
 class Profile {
   constructor() {
     /** @private {?string} */
     this.template_ = null
-
-    /** @private {!Array<string>} */
-    this.extensions_ = []
-  }
-
-  addExtensions(/** !Array<string> */ paths) {
-    this.extensions_ = this.extensions_.concat(...paths)
   }
 
   /**
@@ -199,39 +132,21 @@ class Profile {
    *     profile, or undefined if there's no data to include.
    */
   [Symbols.serialize]() {
-    if (this.template_ || this.extensions_.length) {
-      return buildProfile(this.template_, this.extensions_)
+    if (this.template_) {
+      return buildProfile(this.template_)
     }
     return undefined
   }
 }
 
 /**
- * @param {?string} template path to an existing profile to use as a template.
- * @param {!Array<string>} extensions paths to extensions to install in the new
- *     profile.
+ * @param {string} template path to an existing profile to use as a template.
  * @return {!Promise<string>} a promise for the base64 encoded profile.
  */
-async function buildProfile(template, extensions) {
-  let dir = template
-
-  if (extensions.length) {
-    dir = await io.tmpDir()
-    if (template) {
-      await io.copyDir(/** @type {string} */ (template), dir, /(parent\.lock|lock|\.parentlock)/)
-    }
-
-    const extensionsDir = path.join(dir, 'extensions')
-    await io.mkdir(extensionsDir)
-
-    for (let i = 0; i < extensions.length; i++) {
-      await installExtension(extensions[i], extensionsDir)
-    }
-  }
-
+async function buildProfile(template) {
   let zip = new Zip()
   return zip
-    .addDir(dir)
+    .addDir(template)
     .then(() => zip.toBuffer())
     .then((buf) => buf.toString('base64'))
 }
@@ -312,18 +227,6 @@ class Options extends Capabilities {
     return this.addArguments(`--width=${width}`, `--height=${height}`)
   }
 
-  /**
-   * Add extensions that should be installed when starting Firefox.
-   *
-   * @param {...string} paths The paths to the extension XPI files to install.
-   * @return {!Options} A self reference.
-   * @deprecated Use {@link Driver#installAddon} instead.
-   */
-  addExtensions(...paths) {
-    this.profile_().addExtensions(paths)
-    return this
-  }
-
   /**
    * @param {string} key the preference key.
    * @param {(string|number|boolean)} value the preference value.

package/index.js

@@ -540,6 +540,14 @@ class Builder {
     return this
   }
 
+  /**
+   * @return {edge.Options} the Edge specific options currently configured
+   *     for this builder.
+   */
+  getEdgeOptions() {
+    return this.edgeOptions_
+  }
+
   /**
    * Sets the {@link edge.ServiceBuilder} to use to manage the
    * MicrosoftEdgeDriver child process when creating sessions locally.

package/lib/atoms/find-elements.js

@@ -83,7 +83,16 @@ module.exports = (function findElements(target, root) {
         if (target === '') {
             throw botError(INVALID_SELECTOR, 'Unable to locate an element with the tagName ""');
         }
-        return Array.from(root.getElementsByTagName(target));
+        if ('getElementsByTagName' in root) {
+            return Array.from(root.getElementsByTagName(target));
+        }
+        const elements = Array.from(root.querySelectorAll('*'));
+        if (target === '*') {
+            return elements;
+        }
+        const html = 'http://www.w3.org/1999/xhtml';
+        const folded = target.toLowerCase();
+        return elements.filter(el => el.namespaceURI === html ? el.localName === folded : el.localName === target);
     }
     const DEFAULT_NS_RESOLVER = (function () {
         const ns = { svg: 'http://www.w3.org/2000/svg' };
@@ -166,7 +175,10 @@ module.exports = (function findElements(target, root) {
             return resolveAnchor(selector());
         }
         if (selector && typeof selector === 'object') {
-            const found = findElements(selector);
+            let found = root ? findElements(selector, root) : [];
+            if (!found.length) {
+                found = findElements(selector);
+            }
             if (!found.length) {
                 throw botError(NO_SUCH_ELEMENT, 'No element has been found by ' + JSON.stringify(selector));
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.48.0",
+  "version": "4.50.0",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [
@@ -24,29 +24,29 @@
   },
   "dependencies": {
     "@bazel/runfiles": "^6.5.0",
-    "jszip": "^3.10.1",
+    "jszip": "^3.10.2",
     "tmp": "^0.2.7",
-    "ws": "^8.21.3"
+    "ws": "^8.22.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "cddl": "^0.21.1",
-    "cddl2ts": "^0.10.1",
+    "cddl": "^0.21.2",
+    "cddl2ts": "^0.10.2",
     "clean-jsdoc-theme": "^4.3.3",
-    "eslint": "^10.8.1",
+    "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-mocha": "^11.3.0",
-    "eslint-plugin-n": "^18.3.0",
+    "eslint-plugin-n": "^18.4.0",
     "eslint-plugin-no-only-tests": "^3.4.0",
     "eslint-plugin-prettier": "^5.5.6",
     "express": "^5.2.1",
-    "globals": "^17.9.0",
+    "globals": "^17.12.0",
     "has-flag": "^5.0.1",
     "jsdoc": "^4.0.5",
     "mocha": "^11.8.0",
     "mocha-junit-reporter": "^2.2.1",
-    "multer": "^2.2.0",
-    "prettier": "^3.9.6",
+    "multer": "^2.4.0",
+    "prettier": "^3.9.9",
     "serve-index": "^1.9.2",
     "sinon": "^22.1.0",
     "supports-color": "^10.2.2"

package/remote/index.js

@@ -471,6 +471,8 @@ class SeleniumServer extends DriverService {
       throw Error('Port must be >= 0: ' + options.port)
     }
 
+    const java = options.java || getJavaPath()
+
     let port = options.port || portprober.findFreePort()
     let args = Promise.all([port, options.jvmArgs || [], options.args || []]).then((resolved) => {
       let port = resolved[0]
@@ -479,11 +481,9 @@ class SeleniumServer extends DriverService {
 
       const fullArgsList = jvmArgs.concat('-jar', jar, '-port', port).concat(args)
 
-      return formatSpawnArgs(jar, fullArgsList)
+      return formatSpawnArgs(jar, fullArgsList, java)
     })
 
-    const java = getJavaPath()
-
     super(java, {
       loopback: options.loopback,
       port: port,
@@ -536,6 +536,15 @@ SeleniumServer.Options = class {
      */
     this.jvmArgs
 
+    /**
+     * Path to the java executable that runs the server. Defaults to
+     * `$JAVA_HOME/bin/java` when `JAVA_HOME` is set, otherwise `java` on the
+     * `PATH`.
+     *
+     * @type {(string|undefined)}
+     */
+    this.java
+
     /**
      * The environment variables that should be visible to the server
      * process. Defaults to inheriting the current process's environment.

package/remote/util.js

@@ -31,11 +31,10 @@ function getJavaPath() {
 
 /**
  * @param {string} seleniumStandalonePath path to standalone server
+ * @param {string=} javaPath the java executable; defaults to {@link getJavaPath}
  * @returns {boolean}
  */
-function isSelenium3x(seleniumStandalonePath) {
-  const javaPath = getJavaPath()
-
+function isSelenium3x(seleniumStandalonePath, javaPath = getJavaPath()) {
   const execRes = cp.execFileSync(javaPath, ['-jar', seleniumStandalonePath, '--version'])
 
   return execRes.toString().trim().startsWith('Selenium server version: 3')
@@ -44,11 +43,12 @@ function isSelenium3x(seleniumStandalonePath) {
 /**
  * @param {string} seleniumStandalonePath path to standalone server
  * @param {Array.<string>} args spawn arguments array
+ * @param {string=} javaPath the java executable; defaults to {@link getJavaPath}
  * returns formatted args based on selenium standalone server version
  * @returns {Array.<string>}
  */
-function formatSpawnArgs(seleniumStandalonePath, args) {
-  if (isSelenium3x(seleniumStandalonePath)) {
+function formatSpawnArgs(seleniumStandalonePath, args, javaPath = getJavaPath()) {
+  if (isSelenium3x(seleniumStandalonePath, javaPath)) {
     logging
       .getLogger(logging.Type.SERVER)
       .warning('Deprecation: Support for Standalone Server 3.x will be removed soon. Please update to version 4.x')

package/testing/index.js

@@ -218,6 +218,7 @@ function init(force = false) {
   seleniumJar = process.env['SELENIUM_SERVER_JAR']
   seleniumUrl = process.env['SELENIUM_REMOTE_URL']
   if (seleniumJar) {
+    seleniumJar = locate(seleniumJar)
     info(`Using Selenium server jar: ${seleniumJar}`)
   }
 
@@ -289,6 +290,19 @@ class Environment {
     return () => browsersToIgnore.indexOf(this.browser.name) !== -1
   }
 
+  /**
+   * Returns a predicate function that will suppress tests in this environment
+   * when it runs them through a Selenium server (such as a Grid) rather than a
+   * browser driver started locally.
+   *
+   *     ignore(env.remote()).it('reads a browser preference', ...)
+   *
+   * @return {function(): boolean} a new predicate function.
+   */
+  remote() {
+    return () => URL_MAP.get(this) !== null
+  }
+
   /**
    * @return {!Builder} a new WebDriver builder configured to target this
    *     environment's {@linkplain #browser browser}.
@@ -315,6 +329,19 @@ class Environment {
       builder.setChromeOptions(options)
     }
     // Edge
+    if ('SE_EDGEDRIVER' in process.env) {
+      const found = locate(process.env.SE_EDGEDRIVER)
+      const service = new edge.ServiceBuilder(found)
+      builder.setEdgeService(service)
+    }
+    if ('SE_EDGE' in process.env) {
+      const binary = locate(process.env.SE_EDGE)
+      const options = new edge.Options()
+      options.setBinaryPath(binary)
+      options.setAcceptInsecureCerts(true)
+      options.addArguments('disable-infobars', 'disable-breakpad', 'disable-dev-shm-usage', 'no-sandbox')
+      builder.setEdgeOptions(options)
+    }
     // Firefox
     if ('SE_GECKODRIVER' in process.env) {
       const found = locate(process.env.SE_GECKODRIVER)
@@ -444,7 +471,11 @@ function suite(fn, options = undefined) {
 
       describe(`[${browser.name}]`, function () {
         if (!seleniumUrl && seleniumJar && !seleniumServer) {
-          seleniumServer = new remote.SeleniumServer(seleniumJar)
+          seleniumServer = new remote.SeleniumServer(seleniumJar, {
+            java: bazelJava(),
+            loopback: true,
+            args: ['--host', '127.0.0.1', ...pinnedGridArgs(targetBrowsers.map((b) => b.name))],
+          })
 
           const startTimeout = 65 * 1000
 
@@ -547,6 +578,58 @@ function getTestHook(name) {
   return fn
 }
 
+/**
+ * Bazel's hermetic java, from `SE_BAZEL_JAVA_LOCATION` (a file holding the `$(JAVA)` path).
+ * @return {(string|undefined)} the java executable, or undefined to use the server's default.
+ */
+function bazelJava() {
+  const javaLocation = process.env['SE_BAZEL_JAVA_LOCATION']
+  if (!javaLocation) {
+    return undefined
+  }
+  // $(JAVA) is an exec path (external/<repo>/...); without the prefix it is a runfiles path.
+  const execPath = fs.readFileSync(locate(javaLocation), { encoding: 'utf8' }).trim()
+  const java = locate(execPath.replace(/^external\//, ''))
+  // Resolve the JDK symlink to its real path to dodge a Windows JVM bug mapping lib\modules.
+  return process.platform === 'win32' ? fs.realpathSync(java) : java
+}
+
+/** Browser name -> [driver env var, browser env var, vendor options key], for pinned browsers. */
+const PINNED_BROWSERS = {
+  [Browser.CHROME]: ['SE_CHROMEDRIVER', 'SE_CHROME', 'goog:chromeOptions'],
+  [Browser.FIREFOX]: ['SE_GECKODRIVER', 'SE_FIREFOX', 'moz:firefoxOptions'],
+  [Browser.EDGE]: ['SE_EDGEDRIVER', 'SE_EDGE', 'ms:edgeOptions'],
+}
+
+/**
+ * Pins the Grid node to the Bazel-provided driver and browser; on CI, Selenium Manager would find
+ * no installed browser.
+ * @param {!Array<string>} browserNames the browsers sharing the server.
+ * @return {!Array<string>} empty to keep driver detection.
+ */
+function pinnedGridArgs(browserNames) {
+  // The command line merges repeated --driver-configuration flags into one, so only a single
+  // browser can be pinned; with several, detection must stay on to give each one a slot.
+  if (browserNames.length !== 1) {
+    return []
+  }
+  const [browserName] = browserNames
+  const [driverVar, browserVar, vendorKey] = PINNED_BROWSERS[browserName] ?? []
+  if (!process.env[driverVar] || !process.env[browserVar]) {
+    return []
+  }
+  const stereotype = JSON.stringify({ browserName, [vendorKey]: { binary: locate(process.env[browserVar]) } })
+  return [
+    '--detect-drivers',
+    'false',
+    '--driver-configuration',
+    `display-name=${browserName}`,
+    'max-sessions=1',
+    `webdriver-executable=${locate(process.env[driverVar])}`,
+    `stereotype=${stereotype}`,
+  ]
+}
+
 function locate(fileLike) {
   if (fs.existsSync(fileLike)) {
     return fileLike