selenium-webdriver 4.40.0 → 4.41.0

package/CHANGES.md

@@ -1,3 +1,13 @@
+## 4.41.0
+
+- Support CDP versions: v143, v144, v145
+- Canonical approach to supporting AI agent directions (#16735)
+- [build] Fix Bazel JSDocs implementation (#16949)
+- create task to update dependencies (#16942)
+- Add eslint binary target for selenium-webdriver (#16992)
+- SE_DEBUG warns only when overriding user settings (#17009)
+- [grid] Add session event API for server-side event bus integration (#17015)
+
 ## 4.40.0
 
 - fix JS tests on RBE (#16777)

package/bidi/storage.js

@@ -44,7 +44,7 @@ class Storage {
    *
    * @param {CookieFilter} [filter] - The filter to apply to the cookies.
    * @param {(BrowsingContextPartitionDescriptor|StorageKeyPartitionDescriptor)} [partition] - The partition to retrieve cookies from.
-   * @returns {Promise<{ cookies: Cookie[], partitionKey?: PartitionKey }>} - A promise that resolves to an object containing the retrieved cookies and an optional partition key.
+   * @returns {Promise<{ cookies: Cookie[], partitionKey: (PartitionKey|undefined) }>} - A promise that resolves to an object containing the retrieved cookies and an optional partition key.
    * @throws {Error} If the filter parameter is provided but is not an instance of CookieFilter.
    * @throws {Error} If the partition parameter is provided but is not an instance of BrowsingContextPartitionDescriptor or StorageKeyPartitionDescriptor.
    */

package/lib/command.js

@@ -186,6 +186,8 @@ const Name = {
   DOWNLOAD_FILE: 'downloadFile',
   DELETE_DOWNLOADABLE_FILES: 'deleteDownloadableFiles',
 
+  FIRE_SESSION_EVENT: 'fireSessionEvent',
+
   // Federated Credential Management API
   // https://www.w3.org/TR/fedcm/#automation
   CANCEL_DIALOG: 'cancelDialog',

package/lib/http.js

@@ -321,6 +321,8 @@ const W3C_COMMAND_MAP = new Map([
   [cmd.Name.DOWNLOAD_FILE, post(`/session/:sessionId/se/files`)],
   [cmd.Name.DELETE_DOWNLOADABLE_FILES, del(`/session/:sessionId/se/files`)],
 
+  [cmd.Name.FIRE_SESSION_EVENT, post(`/session/:sessionId/se/event`)],
+
   // Federated Credential Management Command
   [cmd.Name.CANCEL_DIALOG, post(`/session/:sessionId/fedcm/canceldialog`)],
   [cmd.Name.SELECT_ACCOUNT, post(`/session/:sessionId/fedcm/selectaccount`)],

package/lib/logging.js

@@ -486,6 +486,11 @@ const logManager = new LogManager()
 if (typeof process !== 'undefined' && process.env && (process.env.SE_DEBUG || process.env.SELENIUM_VERBOSE)) {
   logManager.root_.setLevel(Level.ALL)
   logManager.root_.addHandler(consoleHandler)
+  if (process.env.SE_DEBUG) {
+    logManager.root_.warning(
+      'Environment Variable `SE_DEBUG` is set; Selenium is forcing verbose logging which may override user-specified settings.',
+    )
+  }
 }
 
 /**

package/lib/webdriver.js

@@ -1744,6 +1744,38 @@ class WebDriver {
 
     return await this.execute(new command.Command(command.Name.DELETE_DOWNLOADABLE_FILES))
   }
+
+  /**
+   * Fires a custom session event to the remote server event bus.
+   *
+   * This allows test code to trigger server-side utilities that subscribe to the event bus.
+   *
+   * @param {string} eventType The type of event (e.g., "test:failed", "log:collect").
+   * @param {Object=} payload Optional data to include with the event.
+   * @return {!Promise<Object>} A promise that resolves to the response containing
+   *     success status, event type, and timestamp.
+   *
+   * @example
+   * // Fire a simple event
+   * await driver.fireSessionEvent('test:started');
+   *
+   * @example
+   * // Fire an event with payload
+   * await driver.fireSessionEvent('test:failed', {
+   *   testName: 'LoginTest',
+   *   error: 'Element not found'
+   * });
+   */
+  async fireSessionEvent(eventType, payload = null) {
+    if (!eventType || typeof eventType !== 'string') {
+      throw new error.InvalidArgumentError('eventType must be a non-empty string')
+    }
+    const cmd = new command.Command(command.Name.FIRE_SESSION_EVENT).setParameter('eventType', eventType)
+    if (payload) {
+      cmd.setParameter('payload', payload)
+    }
+    return await this.execute(cmd)
+  }
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.40.0",
+  "version": "4.41.0",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [
@@ -26,26 +26,26 @@
     "@bazel/runfiles": "^6.5.0",
     "jszip": "^3.10.1",
     "tmp": "^0.2.5",
-    "ws": "^8.18.3"
+    "ws": "^8.19.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
+    "@eslint/js": "^9.39.2",
     "clean-jsdoc-theme": "^4.3.0",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-mocha": "^10.5.0",
-    "eslint-plugin-n": "^17.23.1",
+    "eslint-plugin-n": "^17.24.0",
     "eslint-plugin-no-only-tests": "^3.3.0",
-    "eslint-plugin-prettier": "^5.5.4",
-    "express": "^4.21.2",
+    "eslint-plugin-prettier": "^5.5.5",
+    "express": "^4.22.1",
     "globals": "^15.15.0",
     "has-flag": "^5.0.1",
     "jsdoc": "^4.0.5",
     "mocha": "^11.7.5",
     "mocha-junit-reporter": "^2.2.1",
     "multer": "2.0.2",
-    "prettier": "^3.6.2",
-    "serve-index": "^1.9.1",
+    "prettier": "^3.8.1",
+    "serve-index": "^1.9.2",
     "sinon": "^19.0.5",
     "supports-color": "^10.2.2"
   },