selenium-webdriver 4.45.0 → 4.46.0

package/CHANGES.md

@@ -1,3 +1,10 @@
+## 4.46.0
+
+- Support CDP versions: v148, v149, v150
+- Add binding-neutral BiDi schema with cddl2ts-gated fidelity (#17700)
+- Update cddl to 0.21.0 to fix quoted reserved-word parsing in BiDi codegen (#17752)
+- Add guidance for testing conventions in each language (#16734)
+
 ## 4.45.0
 
 - Support CDP versions: v147, v148, v149

package/bidi/generated/browser.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Browser = exports.getBrowserInstance = void 0;
+exports.Browser = void 0;
+exports.getBrowserInstance = getBrowserInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Browser.create} instead — will be removed in a future major version. */
 async function getBrowserInstance(driver) {
     return Browser.create(driver);
 }
-exports.getBrowserInstance = getBrowserInstance;
 // --- Implementation ---
 class Browser {
     constructor(bidi) {

package/bidi/generated/browsing_context.d.ts

@@ -2,8 +2,8 @@ import type { BrowserClientWindow, BrowserUserContext } from './browser.js';
 import type { EmptyResult, JsInt, JsUint } from './common.js';
 import type { ScriptNodeRemoteValue, ScriptSerializationOptions, ScriptSharedReference } from './script.js';
 import type { SessionUserPromptHandlerType } from './session.js';
-export type BrowsingContextCommand = BrowsingContextActivate | BrowsingContextCaptureScreenshot | BrowsingContextClose | BrowsingContextCreate | BrowsingContextGetTree | BrowsingContextHandleUserPrompt | BrowsingContextLocateNodes | BrowsingContextNavigate | BrowsingContextPrint | BrowsingContextReload | BrowsingContextSetBypassCsp | BrowsingContextSetViewport | BrowsingContextTraverseHistory;
-export type BrowsingContextResult = BrowsingContextActivateResult | BrowsingContextCaptureScreenshotResult | BrowsingContextCloseResult | BrowsingContextCreateResult | BrowsingContextGetTreeResult | BrowsingContextHandleUserPromptResult | BrowsingContextLocateNodesResult | BrowsingContextNavigateResult | BrowsingContextPrintResult | BrowsingContextReloadResult | BrowsingContextSetBypassCspResult | BrowsingContextSetViewportResult | BrowsingContextTraverseHistoryResult;
+export type BrowsingContextCommand = BrowsingContextActivate | BrowsingContextCaptureScreenshot | BrowsingContextClose | BrowsingContextCreate | BrowsingContextGetTree | BrowsingContextHandleUserPrompt | BrowsingContextLocateNodes | BrowsingContextNavigate | BrowsingContextPrint | BrowsingContextReload | BrowsingContextSetBypassCsp | BrowsingContextSetViewport | BrowsingContextStartScreencast | BrowsingContextStopScreencast | BrowsingContextTraverseHistory;
+export type BrowsingContextResult = BrowsingContextActivateResult | BrowsingContextCaptureScreenshotResult | BrowsingContextCloseResult | BrowsingContextCreateResult | BrowsingContextGetTreeResult | BrowsingContextHandleUserPromptResult | BrowsingContextLocateNodesResult | BrowsingContextNavigateResult | BrowsingContextPrintResult | BrowsingContextReloadResult | BrowsingContextSetBypassCspResult | BrowsingContextSetViewportResult | BrowsingContextStartScreencastResult | BrowsingContextStopScreencastResult | BrowsingContextTraverseHistoryResult;
 export type BrowsingContextEvent = BrowsingContextContextCreated | BrowsingContextContextDestroyed | BrowsingContextDomContentLoaded | BrowsingContextDownloadEnd | BrowsingContextDownloadWillBegin | BrowsingContextFragmentNavigated | BrowsingContextHistoryUpdated | BrowsingContextLoad | BrowsingContextNavigationAborted | BrowsingContextNavigationCommitted | BrowsingContextNavigationFailed | BrowsingContextNavigationStarted | BrowsingContextUserPromptClosed | BrowsingContextUserPromptOpened;
 export type BrowsingContextBrowsingContext = string;
 export type BrowsingContextInfoList = BrowsingContextInfo[];
@@ -46,6 +46,7 @@ export interface BrowsingContextXPathLocator {
     value: string;
 }
 export type BrowsingContextNavigation = string;
+export type BrowsingContextDownload = string;
 export interface BrowsingContextBaseNavigationInfo {
     context: BrowsingContextBrowsingContext;
     navigation: BrowsingContextNavigation | null;
@@ -257,6 +258,37 @@ export interface BrowsingContextViewport {
     height: JsUint;
 }
 export type BrowsingContextSetViewportResult = EmptyResult;
+export interface BrowsingContextStartScreencast {
+    method: "browsingContext.startScreencast";
+    params: BrowsingContextStartScreencastParameters;
+}
+export interface BrowsingContextStartScreencastParameters {
+    context: BrowsingContextBrowsingContext;
+    mimeType?: string;
+    video?: BrowsingContextMediaTrackConstraints;
+    audio?: boolean;
+}
+export interface BrowsingContextMediaTrackConstraints {
+    width?: JsUint;
+    height?: JsUint;
+    frameRate?: JsUint;
+}
+export interface BrowsingContextStartScreencastResult {
+    screencast: BrowsingContextScreencast;
+    path: string;
+}
+export type BrowsingContextScreencast = string;
+export interface BrowsingContextStopScreencast {
+    method: "browsingContext.stopScreencast";
+    params: BrowsingContextStopScreencastParameters;
+}
+export interface BrowsingContextStopScreencastParameters {
+    screencast: BrowsingContextScreencast;
+}
+export interface BrowsingContextStopScreencastResult {
+    path: string;
+    error?: string;
+}
 export interface BrowsingContextTraverseHistory {
     method: "browsingContext.traverseHistory";
     params: BrowsingContextTraverseHistoryParameters;
@@ -305,6 +337,7 @@ export interface BrowsingContextDownloadWillBegin {
     params: BrowsingContextDownloadWillBeginParams;
 }
 export type BrowsingContextDownloadWillBeginParams = BrowsingContextBaseNavigationInfo & {
+    download: BrowsingContextDownload;
     suggestedFilename: string;
 };
 export interface BrowsingContextDownloadEnd {
@@ -314,9 +347,11 @@ export interface BrowsingContextDownloadEnd {
 export type BrowsingContextDownloadEndParams = (BrowsingContextDownloadCanceledParams | BrowsingContextDownloadCompleteParams);
 export type BrowsingContextDownloadCanceledParams = BrowsingContextBaseNavigationInfo & {
     status: "canceled";
+    download: BrowsingContextDownload;
 };
 export type BrowsingContextDownloadCompleteParams = BrowsingContextBaseNavigationInfo & {
     status: "complete";
+    download: BrowsingContextDownload;
     filepath: string | null;
 };
 export interface BrowsingContextNavigationAborted {
@@ -372,6 +407,8 @@ export declare class BrowsingContext {
     reload(params: BrowsingContextReloadParameters): Promise<BrowsingContextReloadResult>;
     setBypassCSP(params: BrowsingContextSetBypassCspParameters): Promise<void>;
     setViewport(params: BrowsingContextSetViewportParameters): Promise<void>;
+    startScreencast(params: BrowsingContextStartScreencastParameters): Promise<BrowsingContextStartScreencastResult>;
+    stopScreencast(params: BrowsingContextStopScreencastParameters): Promise<BrowsingContextStopScreencastResult>;
     traverseHistory(params: BrowsingContextTraverseHistoryParameters): Promise<void>;
     onContextCreated(callback: (params: BrowsingContextInfo) => void): Promise<void>;
     onContextDestroyed(callback: (params: BrowsingContextInfo) => void): Promise<void>;

package/bidi/generated/browsing_context.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowsingContext = exports.getBrowsingContextInstance = void 0;
+exports.BrowsingContext = void 0;
+exports.getBrowsingContextInstance = getBrowsingContextInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link BrowsingContext.create} instead — will be removed in a future major version. */
 async function getBrowsingContextInstance(driver) {
     return BrowsingContext.create(driver);
 }
-exports.getBrowsingContextInstance = getBrowsingContextInstance;
 // --- Implementation ---
 class BrowsingContext {
     constructor(bidi) {
@@ -151,6 +151,26 @@ class BrowsingContext {
             throw new Error(`${response['error']}: ${response['message']}`);
         }
     }
+    async startScreencast(params) {
+        const response = await this.bidi.send({
+            method: 'browsingContext.startScreencast',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
+    async stopScreencast(params) {
+        const response = await this.bidi.send({
+            method: 'browsingContext.stopScreencast',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
     async traverseHistory(params) {
         const response = await this.bidi.send({
             method: 'browsingContext.traverseHistory',

package/bidi/generated/common.d.ts

@@ -35,4 +35,4 @@ export type EventData = BrowsingContextEvent | InputEvent | LogEvent | NetworkEv
 export type Extensible = Record<string, unknown>;
 export type JsInt = number;
 export type JsUint = number;
-export type ErrorCode = "invalid argument" | "invalid selector" | "invalid session id" | "invalid web extension" | "move target out of bounds" | "no such alert" | "no such network collector" | "no such element" | "no such frame" | "no such handle" | "no such history entry" | "no such intercept" | "no such network data" | "no such node" | "no such request" | "no such script" | "no such storage partition" | "no such user context" | "no such web extension" | "session not created" | "unable to capture screen" | "unable to close browser" | "unable to set cookie" | "unable to set file input" | "unavailable network data" | "underspecified storage partition" | "unknown command" | "unknown error" | "unsupported operation";
+export type ErrorCode = "invalid argument" | "invalid selector" | "invalid session id" | "invalid web extension" | "move target out of bounds" | "no such alert" | "no such network collector" | "no such element" | "no such frame" | "no such handle" | "no such history entry" | "no such intercept" | "no such network data" | "no such node" | "no such request" | "no such screencast" | "no such script" | "no such storage partition" | "no such user context" | "no such web extension" | "session not created" | "unable to capture screen" | "unable to close browser" | "unable to set cookie" | "unable to set file input" | "unavailable network data" | "underspecified storage partition" | "unknown command" | "unknown error" | "unsupported operation";

package/bidi/generated/input.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Input = exports.getInputInstance = void 0;
+exports.Input = void 0;
+exports.getInputInstance = getInputInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Input.create} instead — will be removed in a future major version. */
 async function getInputInstance(driver) {
     return Input.create(driver);
 }
-exports.getInputInstance = getInputInstance;
 // --- Implementation ---
 class Input {
     constructor(bidi) {

package/bidi/generated/log.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Log = exports.getLogInspectorInstance = void 0;
+exports.Log = void 0;
+exports.getLogInspectorInstance = getLogInspectorInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Log.create} instead — will be removed in a future major version. */
 async function getLogInspectorInstance(driver) {
     return Log.create(driver);
 }
-exports.getLogInspectorInstance = getLogInspectorInstance;
 // --- Implementation ---
 class Log {
     constructor(bidi) {

package/bidi/generated/network.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Network = exports.getNetworkInstance = void 0;
+exports.Network = void 0;
+exports.getNetworkInstance = getNetworkInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Network.create} instead — will be removed in a future major version. */
 async function getNetworkInstance(driver) {
     return Network.create(driver);
 }
-exports.getNetworkInstance = getNetworkInstance;
 // --- Implementation ---
 class Network {
     constructor(bidi) {

package/bidi/generated/script.d.ts

@@ -72,7 +72,7 @@ export interface ScriptUndefinedValue {
     type: "undefined";
 }
 export interface ScriptNullValue {
-    type: null;
+    type: "null";
 }
 export interface ScriptStringValue {
     type: "string";

package/bidi/generated/script.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Script = exports.getScriptManagerInstance = void 0;
+exports.Script = void 0;
+exports.getScriptManagerInstance = getScriptManagerInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Script.create} instead — will be removed in a future major version. */
 async function getScriptManagerInstance(driver) {
     return Script.create(driver);
 }
-exports.getScriptManagerInstance = getScriptManagerInstance;
 // --- Implementation ---
 class Script {
     constructor(bidi) {

package/bidi/generated/storage.js

@@ -16,13 +16,13 @@
 // specific language governing permissions and limitations
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Storage = exports.getStorageInstance = void 0;
+exports.Storage = void 0;
+exports.getStorageInstance = getStorageInstance;
 // --- Additional Types ---
 /** @deprecated Use {@link Storage.create} instead — will be removed in a future major version. */
 async function getStorageInstance(driver) {
     return Storage.create(driver);
 }
-exports.getStorageInstance = getStorageInstance;
 // --- Implementation ---
 class Storage {
     constructor(bidi) {

package/lib/until.js

@@ -113,15 +113,13 @@ function alertIsPresent() {
       .switchTo()
       .alert()
       .catch(function (e) {
-        if (
-          !(
-            e instanceof error.NoSuchAlertError ||
-            // XXX: Workaround for GeckoDriver error `TypeError: can't convert null
-            // to object`. For more details, see
-            // https://github.com/SeleniumHQ/selenium/pull/2137
-            (e instanceof error.WebDriverError && e.message === `can't convert null to object`)
-          )
-        ) {
+        if (!(
+          e instanceof error.NoSuchAlertError ||
+          // XXX: Workaround for GeckoDriver error `TypeError: can't convert null
+          // to object`. For more details, see
+          // https://github.com/SeleniumHQ/selenium/pull/2137
+          (e instanceof error.WebDriverError && e.message === `can't convert null to object`)
+        )) {
           throw e
         }
       })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.45.0",
+  "version": "4.46.0",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [
@@ -30,23 +30,23 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "cddl": "^0.20.1",
-    "cddl2ts": "^0.9.1",
-    "clean-jsdoc-theme": "^4.3.2",
-    "eslint": "^10.5.0",
+    "cddl": "^0.21.0",
+    "cddl2ts": "^0.10.0",
+    "clean-jsdoc-theme": "^4.3.3",
+    "eslint": "^10.7.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-mocha": "^11.3.0",
-    "eslint-plugin-n": "^18.1.0",
+    "eslint-plugin-n": "^18.2.1",
     "eslint-plugin-no-only-tests": "^3.4.0",
     "eslint-plugin-prettier": "^5.5.6",
     "express": "^5.2.1",
-    "globals": "^17.6.0",
+    "globals": "^17.7.0",
     "has-flag": "^5.0.1",
     "jsdoc": "^4.0.5",
     "mocha": "^11.7.6",
     "mocha-junit-reporter": "^2.2.1",
-    "multer": "^2.1.1",
-    "prettier": "^3.8.4",
+    "multer": "^2.2.0",
+    "prettier": "^3.9.5",
     "serve-index": "^1.9.2",
     "sinon": "^22.0.0",
     "supports-color": "^10.2.2"