selenium-webdriver 4.46.0 → 4.47.0

package/CHANGES.md

@@ -1,3 +1,24 @@
+## 4.47.0
+
+- Support CDP versions: v149, v150, v151
+- link generated BiDi elements to their spec definitions (#17781)
+- add objectOnly/preserveExtras/scalar-primitive BiDi schema signals (#17784)
+- [build] Fix GeckoDriver rejecting system-access via capabilities (#17811)
+- [build] standardize generated-file license and not to edit markers across generators (#17816)
+- [build] Download and bundle Selenium Manager SBOM and NOTICE in each package (#17820)
+- [build] BiDi schema generation cleanup (#17837)
+- [build] Merge vendor cddl files into shared BiDi schema and implement custom Firefox webExtension options (#17840)
+- [grid] honor client-advertised se:remoteUrl for reachable BiDi/CDP/VNC URLs (#17790)
+- remove deprecated FTP proxy support (#17846)
+- [bidi] Correct float/enum type fidelity in the shared schema and validate primitives outbound in Ruby (#17852)
+- [bidi] mark BiDi types extensible per spec and update Ruby handling (#17853)
+- validate BiDi outbound ref fields against their declared type (#17861)
+- [build] derive per-type inbound/outbound directionality in the shared schema (#17864)
+- [build] update node versioning for testing and publishing (#17866)
+- Wait for async BiDi events and window resize in flaky tests (#17874)
+- deprecate invalid Firefox profile code (#17871)
+- [build] Automated Browser Version Update with CDP (#17873)
+
 ## 4.46.0
 
 - Support CDP versions: v148, v149, v150

package/README.md

@@ -3,7 +3,7 @@
 JavaScript language bindings for [Selenium WebDriver](https://www.selenium.dev).
 Selenium automates browsers for testing and web-based task automation.
 
-Requires Node.js >= 20.
+Requires Node.js >= 22.
 
 ## Installation
 
@@ -63,17 +63,20 @@ SELENIUM_REMOTE_URL="http://localhost:4444" node script.js
 
 ## Node Support Policy
 
-Each `selenium-webdriver` release targets the latest _semver-minor_ of Node's
-[LTS and Current releases](https://github.com/nodejs/release#release-schedule).
+`selenium-webdriver` supports the Node.js versions under active upstream
+support. Each is supported until its
+[end-of-life](https://github.com/nodejs/release#release-schedule) date; after
+that it is unsupported.
 
-| Level         | Guarantee                                                                 |
-| :------------ | :------------------------------------------------------------------------ |
-| _supported_   | API compatible without runtime flags; bugs investigated and fixed.        |
-| _best effort_ | Bugs investigated as time permits; API compatibility only where required. |
-| _unsupported_ | Bug reports closed as will-not-fix; API compatibility not guaranteed.     |
+| Node.js | Support ends |
+| :------ | :----------- |
+| 22      | 2027-04-30   |
+| 24      | 2028-04-30   |
+| 26      | 2029-04-30   |
 
-Versions older than the active LTS, unstable release branches (e.g. `v.Next`),
-and _semver-major_ Node releases outside the LTS / Current pair are _unsupported_.
+CI tests the earliest and latest supported versions available in
+[rules_nodejs](https://github.com/bazel-contrib/rules_nodejs); issues and pull
+requests are welcome for any supported version.
 
 ## Documentation
 

package/bidi/generated/common.js

@@ -28,3 +28,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // (https://github.com/w3c/webref)
 // Content was automatically extracted by Reffy into webref
 // (https://github.com/w3c/webref)
+// Local copy of w3c/webdriver-bidi#1140: adds the webExtension.install extension point.
+// Overrides the upstream closed InstallParameters. Delete once #1140 merges and the
+// pinned webref carries it. https://github.com/w3c/webdriver-bidi/pull/1140

package/bidi/generated/emulation.d.ts

@@ -1,8 +1,8 @@
 import type { BrowserUserContext } from './browser.js';
 import type { BrowsingContextBrowsingContext } from './browsing_context.js';
 import type { EmptyResult, JsUint } from './common.js';
-export type EmulationCommand = EmulationSetForcedColorsModeThemeOverride | EmulationSetGeolocationOverride | EmulationSetLocaleOverride | EmulationSetNetworkConditions | EmulationSetScreenOrientationOverride | EmulationSetScreenSettingsOverride | EmulationSetScriptingEnabled | EmulationSetScrollbarTypeOverride | EmulationSetTimezoneOverride | EmulationSetTouchOverride | EmulationSetUserAgentOverride;
-export type EmulationResult = EmulationSetForcedColorsModeThemeOverrideResult | EmulationSetGeolocationOverrideResult | EmulationSetLocaleOverrideResult | EmulationSetScreenOrientationOverrideResult | EmulationSetScriptingEnabledResult | EmulationSetScrollbarTypeOverrideResult | EmulationSetTimezoneOverrideResult | EmulationSetTouchOverrideResult | EmulationSetUserAgentOverrideResult;
+export type EmulationCommand = EmulationSetForcedColorsModeThemeOverride | EmulationSetGeolocationOverride | EmulationSetLocaleOverride | EmulationSetMediaFeaturesOverride | EmulationSetNetworkConditions | EmulationSetScreenOrientationOverride | EmulationSetScreenSettingsOverride | EmulationSetScriptingEnabled | EmulationSetScrollbarTypeOverride | EmulationSetTimezoneOverride | EmulationSetTouchOverride | EmulationSetUserAgentOverride | EmulationSetViewportMetaOverride;
+export type EmulationResult = EmulationSetForcedColorsModeThemeOverrideResult | EmulationSetGeolocationOverrideResult | EmulationSetLocaleOverrideResult | EmulationSetMediaFeaturesOverrideResult | EmulationSetScreenOrientationOverrideResult | EmulationSetScriptingEnabledResult | EmulationSetScrollbarTypeOverrideResult | EmulationSetTimezoneOverrideResult | EmulationSetTouchOverrideResult | EmulationSetUserAgentOverrideResult | EmulationSetViewportMetaOverrideResult;
 export interface EmulationSetForcedColorsModeThemeOverride {
     method: "emulation.setForcedColorsModeThemeOverride";
     params: EmulationSetForcedColorsModeThemeOverrideParameters;
@@ -64,6 +64,21 @@ export interface EmulationSetLocaleOverrideParameters {
     userContexts?: BrowserUserContext[];
 }
 export type EmulationSetLocaleOverrideResult = EmptyResult;
+export interface EmulationSetMediaFeaturesOverride {
+    method: "emulation.setMediaFeaturesOverride";
+    params: EmulationSetMediaFeaturesOverrideParameters;
+}
+export interface EmulationSetMediaFeaturesOverrideParameters {
+    features: EmulationMediaFeatures | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationMediaFeatures = EmulationMediaFeature[];
+export interface EmulationMediaFeature {
+    name: string;
+    value: string;
+}
+export type EmulationSetMediaFeaturesOverrideResult = EmptyResult;
 export interface EmulationSetNetworkConditions {
     method: "emulation.setNetworkConditions";
     params: EmulationSetNetworkConditionsParameters;
@@ -118,6 +133,16 @@ export interface EmulationSetUserAgentOverrideParameters {
     userContexts?: BrowserUserContext[];
 }
 export type EmulationSetUserAgentOverrideResult = EmptyResult;
+export interface EmulationSetViewportMetaOverride {
+    method: "emulation.setViewportMetaOverride";
+    params: EmulationSetViewportMetaOverrideParameters;
+}
+export interface EmulationSetViewportMetaOverrideParameters {
+    viewportMeta: true | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetViewportMetaOverrideResult = EmptyResult;
 export interface EmulationSetScriptingEnabled {
     method: "emulation.setScriptingEnabled";
     params: EmulationSetScriptingEnabledParameters;
@@ -165,6 +190,7 @@ export declare class Emulation {
     setForcedColorsModeThemeOverride(params: EmulationSetForcedColorsModeThemeOverrideParameters): Promise<void>;
     setGeolocationOverride(params: EmulationSetGeolocationOverrideParameters): Promise<void>;
     setLocaleOverride(params: EmulationSetLocaleOverrideParameters): Promise<void>;
+    setMediaFeaturesOverride(params: EmulationSetMediaFeaturesOverrideParameters): Promise<void>;
     setNetworkConditions(params: EmulationSetNetworkConditionsParameters): Promise<void>;
     setScreenOrientationOverride(params: EmulationSetScreenOrientationOverrideParameters): Promise<void>;
     setScreenSettingsOverride(params: EmulationSetScreenSettingsOverrideParameters): Promise<void>;
@@ -173,4 +199,5 @@ export declare class Emulation {
     setTimezoneOverride(params: EmulationSetTimezoneOverrideParameters): Promise<void>;
     setTouchOverride(params: EmulationSetTouchOverrideParameters): Promise<void>;
     setUserAgentOverride(params: EmulationSetUserAgentOverrideParameters): Promise<void>;
+    setViewportMetaOverride(params: EmulationSetViewportMetaOverrideParameters): Promise<void>;
 }

package/bidi/generated/emulation.js

@@ -57,6 +57,15 @@ class Emulation {
             throw new Error(`${response['error']}: ${response['message']}`);
         }
     }
+    async setMediaFeaturesOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setMediaFeaturesOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
     async setNetworkConditions(params) {
         const response = await this.bidi.send({
             method: 'emulation.setNetworkConditions',
@@ -129,5 +138,14 @@ class Emulation {
             throw new Error(`${response['error']}: ${response['message']}`);
         }
     }
+    async setViewportMetaOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setViewportMetaOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
 }
 exports.Emulation = Emulation;

package/bidi/generated/webextension.d.ts

@@ -1,4 +1,4 @@
-import type { EmptyResult } from './common.js';
+import type { EmptyResult, Extensible } from './common.js';
 export type WebExtensionCommand = WebExtensionInstall | WebExtensionUninstall;
 export type WebExtensionResult = WebExtensionInstallResult | WebExtensionUninstallResult;
 export type WebExtensionExtension = string;
@@ -6,9 +6,6 @@ export interface WebExtensionInstall {
     method: "webExtension.install";
     params: WebExtensionInstallParameters;
 }
-export interface WebExtensionInstallParameters {
-    extensionData: WebExtensionExtensionData;
-}
 export type WebExtensionExtensionData = WebExtensionExtensionArchivePath | WebExtensionExtensionBase64Encoded | WebExtensionExtensionPath;
 export interface WebExtensionExtensionPath {
     type: "path";
@@ -33,6 +30,10 @@ 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();