selenium-webdriver 4.49.0 → 4.50.0

package/bidi/generated/webextension.d.ts

@@ -1,11 +1,14 @@
-import type { EmptyResult, Extensible } from './common.js';
-export type WebExtensionCommand = WebExtensionInstall | WebExtensionUninstall;
-export type WebExtensionResult = WebExtensionInstallResult | WebExtensionUninstallResult;
+import type { EmptyResult } from './common.js';
+import './common.js';
+import { Domain } from '../domain.js';
 export type WebExtensionExtension = string;
 export interface WebExtensionInstall {
     method: "webExtension.install";
     params: WebExtensionInstallParameters;
 }
+export interface WebExtensionInstallParameters {
+    extensionData: WebExtensionExtensionData;
+}
 export type WebExtensionExtensionData = WebExtensionExtensionArchivePath | WebExtensionExtensionBase64Encoded | WebExtensionExtensionPath;
 export interface WebExtensionExtensionPath {
     type: "path";
@@ -30,14 +33,25 @@ export interface WebExtensionUninstallParameters {
     extension: WebExtensionExtension;
 }
 export type WebExtensionUninstallResult = EmptyResult;
-export type WebExtensionInstallParameters = WebExtensionInstallParametersExtension & {
-    extensionData: WebExtensionExtensionData;
-};
-export type WebExtensionInstallParametersExtension = Extensible;
-export declare class WebExtension {
-    private readonly bidi;
-    private constructor();
+/**
+ * This is an unsupported API. No compatibility guarantees are provided.
+ * It tracks the W3C WebDriver BiDi specification directly. As the specification
+ * evolves, this API will change or be removed without prior notice.
+ */
+export declare class WebExtension extends Domain {
     static create(driver: unknown): Promise<WebExtension>;
+    /**
+     * @param {WebExtensionInstallParameters} params
+     * @param {WebExtensionExtensionData} params.extensionData
+     * @returns {Promise<WebExtensionInstallResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-webExtension-install
+     */
     install(params: WebExtensionInstallParameters): Promise<WebExtensionInstallResult>;
+    /**
+     * @param {WebExtensionUninstallParameters} params
+     * @param {WebExtensionExtension} params.extension
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-webExtension-uninstall
+     */
     uninstall(params: WebExtensionUninstallParameters): Promise<void>;
 }

package/bidi/generated/webextension.js

@@ -17,37 +17,51 @@
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebExtension = void 0;
+require("./common.js");
+const record_js_1 = require("../serialization/record.js");
+const union_js_1 = require("../serialization/union.js");
+const domain_js_1 = require("../domain.js");
+(0, record_js_1.defineAlias)('webExtension.Extension', { "primitive": "string" });
+const WebExtensionInstall = (0, record_js_1.defineRecord)('webExtension.Install', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "webExtension.install" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "webExtension.InstallParameters" } }]);
+const WebExtensionInstallParameters = (0, record_js_1.defineRecord)('webExtension.InstallParameters', [{ "name": "extensionData", "wire": "extensionData", "required": true, "type": { "ref": "webExtension.ExtensionData" } }]);
+const WebExtensionExtensionDataUnion = (0, union_js_1.defineUnion)('webExtension.ExtensionData', { "by": "type", "variants": [{ "value": "archivePath", "ref": "webExtension.ExtensionArchivePath" }, { "value": "base64", "ref": "webExtension.ExtensionBase64Encoded" }, { "value": "path", "ref": "webExtension.ExtensionPath" }] }, { "objectOnly": true });
+const WebExtensionExtensionPath = (0, record_js_1.defineRecord)('webExtension.ExtensionPath', [{ "name": "type", "wire": "type", "required": true, "type": { "const": "path" } }, { "name": "path", "wire": "path", "required": true, "type": { "primitive": "string" } }]);
+const WebExtensionExtensionArchivePath = (0, record_js_1.defineRecord)('webExtension.ExtensionArchivePath', [{ "name": "type", "wire": "type", "required": true, "type": { "const": "archivePath" } }, { "name": "path", "wire": "path", "required": true, "type": { "primitive": "string" } }]);
+const WebExtensionExtensionBase64Encoded = (0, record_js_1.defineRecord)('webExtension.ExtensionBase64Encoded', [{ "name": "type", "wire": "type", "required": true, "type": { "const": "base64" } }, { "name": "value", "wire": "value", "required": true, "type": { "primitive": "string" } }]);
+const WebExtensionInstallResult = (0, record_js_1.defineRecord)('webExtension.InstallResult', [{ "name": "extension", "wire": "extension", "required": true, "type": { "ref": "webExtension.Extension" } }]);
+const WebExtensionUninstall = (0, record_js_1.defineRecord)('webExtension.Uninstall', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "webExtension.uninstall" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "webExtension.UninstallParameters" } }]);
+const WebExtensionUninstallParameters = (0, record_js_1.defineRecord)('webExtension.UninstallParameters', [{ "name": "extension", "wire": "extension", "required": true, "type": { "ref": "webExtension.Extension" } }]);
+(0, record_js_1.defineAlias)('webExtension.UninstallResult', { "ref": "EmptyResult" });
 // --- Implementation ---
-class WebExtension {
-    constructor(bidi) {
-        this.bidi = bidi;
-    }
+/**
+ * This is an unsupported API. No compatibility guarantees are provided.
+ * It tracks the W3C WebDriver BiDi specification directly. As the specification
+ * evolves, this API will change or be removed without prior notice.
+ */
+class WebExtension extends domain_js_1.Domain {
     static async create(driver) {
-        const caps = await driver.getCapabilities();
-        if (!caps.get('webSocketUrl')) {
-            throw new Error('WebDriver instance must support BiDi protocol');
-        }
-        const bidi = await driver.getBidi();
-        return new WebExtension(bidi);
+        return new WebExtension(await domain_js_1.Domain.connect(driver), domain_js_1.DOMAIN_TOKEN);
     }
+    /**
+     * @param {WebExtensionInstallParameters} params
+     * @param {WebExtensionExtensionData} params.extensionData
+     * @returns {Promise<WebExtensionInstallResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-webExtension-install
+     */
     async install(params) {
-        const response = await this.bidi.send({
-            method: 'webExtension.install',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new WebExtensionInstallParameters(params);
+        const result = await this.send('webExtension.install', validatedParams);
+        return WebExtensionInstallResult.fromWire(result);
     }
+    /**
+     * @param {WebExtensionUninstallParameters} params
+     * @param {WebExtensionExtension} params.extension
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-webExtension-uninstall
+     */
     async uninstall(params) {
-        const response = await this.bidi.send({
-            method: 'webExtension.uninstall',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
+        const validatedParams = new WebExtensionUninstallParameters(params);
+        await this.send('webExtension.uninstall', validatedParams);
     }
 }
 exports.WebExtension = WebExtension;

package/bidi/serialization/enum.js

@@ -18,10 +18,13 @@
 const { register } = require('./registry')
 
 /**
- * Registers a schema `enum` — a closed set of string values a field may hold.
+ * Registers a schema `enum` — a closed set of string, number, or boolean values a
+ * field may hold (e.g. emulation.MediaFeaturesGrid, CSS's `grid` media feature, is
+ * spec'd as the integer 0 or 1, not a string; the schema projector's literalPrimitive()
+ * recognizes a boolean-literal choice the same way).
  * @param {string} name Schema type name, e.g. 'network.InterceptPhase'.
- * @param {string[]} values The enum's valid values.
- * @returns {{kind: 'enum', values: string[], includes: function(unknown): boolean}}
+ * @param {Array<string|number|boolean>} values The enum's valid values.
+ * @returns {{kind: 'enum', values: Array<string|number|boolean>, includes: function(unknown): boolean}}
  *   The registered entry, used by validateValue() to check a ref'd value's
  *   membership; also returned so a generator can build a discoverable constant from it.
  */

package/bidi/serialization/record.js

@@ -20,14 +20,14 @@ const { register, resolve } = require('./registry')
 class ValidationError extends Error {}
 
 // Validates a *present* value against a resolved type node, and returns the value to
-// assign for it — usually the same value, but for a nested ref-to-record/union parsed
-// inbound (fromWire()/build() results, not the raw wire object) and for list/map/inline
-// record values (a fresh, deeply-frozen copy, so validity can't be corrupted after the
-// fact by mutating an array or object a caller still holds a reference to).
-// Outbound nested refs deliberately keep the caller's own value instead of the
-// newly-constructed instance — the nested `new referenced.RecordClass(value)` /
-// `referenced.build(value)` call below exists only to validate, matching the
-// constructor's existing outbound behavior of trusting the caller's own object shape.
+// assign for it — usually the same value, but for a nested ref-to-record/union (the
+// freshly constructed/parsed instance — fromWire()/build() inbound, `new RecordClass(value)`/
+// build() outbound, not the caller's raw value) and for list/map/inline record values (a
+// fresh, deeply-frozen copy, so validity can't be corrupted after the fact by mutating an
+// array or object a caller still holds a reference to). Outbound needs the constructed
+// instance, symmetric with inbound, so a typed parent's toJSON() cascades into a nested
+// record's own toJSON() — converting *its* fields to their declared wire names too, not
+// just the parent's own fields — when the whole instance is serialized for the wire.
 // `direction` only affects how a nested ref-to-record/union is itself validated/parsed.
 function validateValue(typeNode, value, path, direction) {
   if (value === null) {
@@ -125,23 +125,24 @@ function validateValue(typeNode, value, path, direction) {
         throw new ValidationError(`${path}: expected an object, got ${typeof value}`)
       }
       // Recurse through the same-direction path so a nested field gets the same
-      // tolerance (inbound) or strictness (outbound) as its parent. Inbound returns
-      // the parsed instance itself, so a typed parent record ends up with a typed
-      // nested value instead of the raw wire object; outbound only validates this
-      // way (the caller's own value is what gets kept, see the note above).
+      // tolerance (inbound) or strictness (outbound) as its parent, and — both
+      // directions alike — ends up holding the typed instance, not the raw value:
+      // inbound so a typed parent record has a typed nested value instead of the
+      // raw wire object; outbound so the parent's own toJSON() cascades into this
+      // nested instance's toJSON() too, converting its fields to their wire names.
       if (direction === 'inbound') {
         return referenced.RecordClass.fromWire(value)
       }
-      new referenced.RecordClass(value)
-      return value
+      return new referenced.RecordClass(value)
     }
 
     if (referenced.kind === 'union') {
+      // build()/fromWire() already return the resolved variant's own instance —
+      // same reasoning as the record branch above applies to it symmetrically.
       if (direction === 'inbound') {
         return referenced.fromWire(value)
       }
-      referenced.build(value)
-      return value
+      return referenced.build(value)
     }
 
     if (referenced.kind === 'alias') {
@@ -220,33 +221,37 @@ function defineRecord(name, fields, options = {}) {
 
   class Record {
     // Outbound: strict. Any value that doesn't match its declared shape is an error here.
+    // Reads `data` by JS-facing field name (field.name), not the wire key (field.wire) —
+    // a caller builds params using the same property names the generated TS interface
+    // declares (e.g. `prefersColorScheme`), never the raw spec key (`prefers-color-scheme`);
+    // toJSON() below is what maps back to field.wire for the actual wire send.
     constructor(data) {
       if (typeof data !== 'object' || data === null || Array.isArray(data)) {
         throw new ValidationError(`${name}: expected an object`)
       }
 
       for (const field of fields) {
-        if (!Object.hasOwn(data, field.wire)) {
+        if (!Object.hasOwn(data, field.name)) {
           if (field.required) {
-            throw new ValidationError(`${name}.${field.wire}: required field is missing`)
+            throw new ValidationError(`${name}.${field.name}: required field is missing`)
           }
           continue
         }
-        const value = data[field.wire]
-        this[field.name] = validateValue(field.type, value, `${name}.${field.wire}`, 'outbound')
+        const value = data[field.name]
+        this[field.name] = validateValue(field.type, value, `${name}.${field.name}`, 'outbound')
       }
 
-      for (const wireKey of Object.keys(data)) {
-        if (byWire.has(wireKey)) continue
+      for (const key of Object.keys(data)) {
+        if (byName.has(key)) continue
         if (!extensible) {
-          throw new ValidationError(`${name}: unknown property "${wireKey}"`)
+          throw new ValidationError(`${name}: unknown property "${key}"`)
         }
-        // Object.defineProperty, not `this[wireKey] = ...`: wireKey is caller-supplied
-        // and a literal "__proto__" key assigned via bracket notation hijacks this
-        // instance's actual prototype instead of becoming a field (CWE-1321).
-        // defineProperty always creates a genuine own data property, regardless of name.
-        Object.defineProperty(this, wireKey, {
-          value: data[wireKey], // vendor extras reach the wire on an extensible type
+        // Object.defineProperty, not `this[key] = ...`: key is caller-supplied and a
+        // literal "__proto__" key assigned via bracket notation hijacks this instance's
+        // actual prototype instead of becoming a field (CWE-1321). defineProperty always
+        // creates a genuine own data property, regardless of name.
+        Object.defineProperty(this, key, {
+          value: data[key], // vendor extras have no separate wire name — this key is both
           enumerable: true,
           writable: true,
           configurable: true,

package/bin/selenium-manager-THIRD-PARTY-NOTICES.txt

@@ -1,7 +1,7 @@
 Third-party software bundled with Selenium Manager. Full license texts follow.
 
 Overview of licenses:
-  - MIT License: 247 crate(s)
+  - MIT License: 248 crate(s)
   - Unicode License v3: 19 crate(s)
   - Apache License 2.0: 8 crate(s)
   - Mozilla Public License 2.0: 6 crate(s)
@@ -16,7 +16,7 @@ Apache License 2.0
 ================================================================================
 
 Used by:
-  - selenium-manager 0.4.49-nightly
+  - selenium-manager 0.4.50
 
 
                                  Apache License
@@ -1580,21 +1580,21 @@ MIT License
 
 Used by:
   - bzip2 0.4.4
-  - cc 1.4.5
-  - cfg-if 1.0.4
+  - cc 1.5.1
+  - cfg-if 1.0.5
   - filetime 0.2.29
-  - find-msvc-tools 0.1.12
+  - find-msvc-tools 0.1.14
   - jobserver 0.1.35
-  - js-sys 0.3.105
+  - js-sys 0.3.106
   - openssl-probe 0.2.1
   - pkg-config 0.3.34
   - socket2 0.6.5
-  - wasm-bindgen-futures 0.4.78
-  - wasm-bindgen-macro-support 0.2.128
-  - wasm-bindgen-macro 0.2.128
-  - wasm-bindgen-shared 0.2.128
-  - wasm-bindgen 0.2.128
-  - web-sys 0.3.105
+  - wasm-bindgen-futures 0.4.79
+  - wasm-bindgen-macro-support 0.2.129
+  - wasm-bindgen-macro 0.2.129
+  - wasm-bindgen-shared 0.2.129
+  - wasm-bindgen 0.2.129
+  - web-sys 0.3.106
 
 Copyright (c) 2014 Alex Crichton
 
@@ -1724,7 +1724,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - bitflags 2.13.1
+  - bitflags 2.13.2
   - log 0.4.34
   - num-traits 0.2.19
   - regex-automata 0.4.18
@@ -1763,7 +1763,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - uuid 1.26.0
+  - uuid 1.26.1
 
 Copyright (c) 2014 The Rust Project Developers
 Copyright (c) 2018 Ashley Mannix, Christopher Armstrong, Dylan DPC, Hunar Roop Kahlon
@@ -2271,9 +2271,9 @@ MIT License
 ================================================================================
 
 Used by:
-  - hyper-rustls 0.27.9
+  - hyper-rustls 0.27.10
   - rustls-native-certs 0.8.4
-  - rustls 0.23.43
+  - rustls 0.23.45
 
 Copyright (c) 2016 Joseph Birr-Pixton <jpixton@gmail.com>
 
@@ -2439,7 +2439,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - reqwest 0.13.4
+  - reqwest 0.13.5
 
 Copyright (c) 2016-2026 Sean McArthur
 
@@ -2603,7 +2603,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - tokio-rustls 0.26.5
+  - tokio-rustls 0.26.6
 
 Copyright (c) 2017 quininer kel
 
@@ -2705,7 +2705,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - smallvec 1.16.0
+  - smallvec 1.16.2
 
 Copyright (c) 2018 The Servo Project Developers
 
@@ -3604,7 +3604,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - hyper-util 0.1.20
+  - hyper-util 0.1.21
 
 Copyright (c) 2023-2025 Sean McArthur
 
@@ -3665,17 +3665,17 @@ Used by:
   - anstyle-query 1.1.5
   - anstyle-wincon 3.0.11
   - anstyle 1.0.14
-  - clap 4.6.6
-  - clap_builder 4.6.6
-  - clap_derive 4.6.4
-  - clap_lex 1.1.0
+  - clap 4.6.7
+  - clap_builder 4.6.7
+  - clap_derive 4.6.7
+  - clap_lex 1.1.1
   - colorchoice 1.0.5
   - env_filter 2.0.0
   - env_logger 0.11.11
   - is_terminal_polyfill 1.70.2
   - once_cell_polyfill 1.70.2
   - serde_spanned 1.1.1
-  - toml 1.1.5+spec-1.1.0
+  - toml 1.1.6+spec-1.1.0
   - toml_datetime 1.1.1+spec-1.1.0
   - toml_parser 1.1.3+spec-1.1.0
   - toml_writer 1.1.2+spec-1.1.0
@@ -3900,7 +3900,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - synstructure 0.13.2
+  - synstructure 0.14.0
 
 Copyright 2016 Nika Layzell
 
@@ -3997,7 +3997,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - zerocopy 0.8.56
+  - zerocopy 0.8.59
 
 Copyright 2023 The Fuchsia Authors
 
@@ -4217,7 +4217,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - crc32fast 1.5.1
+  - crc32fast 1.5.2
 
 MIT License
 
@@ -4369,7 +4369,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - rustls-platform-verifier 0.7.0
+  - rustls-platform-verifier 0.7.1
 
 MIT License
 
@@ -4399,7 +4399,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - libredox 0.1.23
+  - libredox 0.1.25
 
 MIT License
 
@@ -4464,7 +4464,7 @@ Used by:
   - jni-sys-macros 0.4.1
   - jni 0.22.4
   - r-efi 6.0.0
-  - rustls-platform-verifier-android 0.1.1
+  - rustls-platform-verifier-android 0.2.0
   - winapi-i686-pc-windows-gnu 0.4.0
   - winapi-x86_64-pc-windows-gnu 0.4.0
   - windows-core 0.62.2
@@ -4570,6 +4570,7 @@ Copyright 2010-2014 Rich Geldreich and Tenacious Software LLC
 Copyright (c) 2017 Frommi
 Copyright (c) 2017-2024 oyvindln
 
+
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -4634,7 +4635,7 @@ Used by:
   - portable-atomic 1.15.0
   - proc-macro2 1.0.107
   - quote 1.0.47
-  - rustix 1.1.4
+  - rustix 1.1.5
   - rustversion 1.0.23
   - semver 1.0.28
   - serde 1.0.229
@@ -4643,13 +4644,13 @@ Used by:
   - serde_json 1.0.151
   - simd_cesu8 1.2.0
   - syn 2.0.119
-  - syn 3.0.5
+  - syn 3.0.6
   - thiserror-impl 1.0.69
-  - thiserror-impl 2.0.20
+  - thiserror-impl 2.0.21
   - thiserror 1.0.69
-  - thiserror 2.0.20
+  - thiserror 2.0.21
   - typed-path 0.12.3
-  - unicode-ident 1.0.24
+  - unicode-ident 1.0.26
   - wasi 0.11.1+wasi-snapshot-preview1
   - zmij 1.0.23
 
@@ -4861,8 +4862,8 @@ MIT License
 Used by:
   - aho-corasick 1.1.5
   - byteorder 1.5.0
-  - jiff-core 0.1.0
-  - jiff 0.2.35
+  - jiff-core 0.1.1
+  - jiff 0.2.37
   - memchr 2.8.3
   - walkdir 2.5.0
 
@@ -5078,7 +5079,7 @@ MIT License
 ================================================================================
 
 Used by:
-  - redox_users 0.5.2
+  - redox_users 0.5.3
 
 The MIT License (MIT)
 
@@ -5104,6 +5105,36 @@ SOFTWARE.
 
 
 
+================================================================================
+MIT License
+================================================================================
+
+Used by:
+  - base64 0.23.1
+
+The MIT License (MIT)
+
+Copyright (c) 2025 Alice Maz, Marshall Pierce
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
 ================================================================================
 MIT License
 ================================================================================
@@ -5982,7 +6013,7 @@ Unicode License v3
 ================================================================================
 
 Used by:
-  - unicode-ident 1.0.24
+  - unicode-ident 1.0.26
 
 UNICODE LICENSE V3
 
@@ -6041,9 +6072,9 @@ Used by:
   - potential_utf 0.1.6
   - tinystr 0.8.4
   - writeable 0.6.4
-  - yoke-derive 0.8.2
+  - yoke-derive 0.8.4
   - yoke 0.8.3
-  - zerofrom-derive 0.1.7
+  - zerofrom-derive 0.1.8
   - zerofrom 0.1.8
   - zerotrie 0.2.5
   - zerovec-derive 0.11.6
@@ -6102,7 +6133,7 @@ zlib License
 ================================================================================
 
 Used by:
-  - zlib-rs 0.6.7
+  - zlib-rs 0.6.8
 
 (C) 2024 Trifecta Tech Foundation