selenium-webdriver 4.48.0 → 4.50.0

package/bidi/generated/session.js

@@ -17,66 +17,99 @@
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Session = void 0;
+require("./browser.js");
+require("./browsing_context.js");
+require("./common.js");
+const record_js_1 = require("../serialization/record.js");
+const enum_js_1 = require("../serialization/enum.js");
+const union_js_1 = require("../serialization/union.js");
+const domain_js_1 = require("../domain.js");
+const SessionCapabilitiesRequest = (0, record_js_1.defineRecord)('session.CapabilitiesRequest', [{ "name": "alwaysMatch", "wire": "alwaysMatch", "required": false, "type": { "ref": "session.CapabilityRequest" } }, { "name": "firstMatch", "wire": "firstMatch", "required": false, "type": { "list": { "ref": "session.CapabilityRequest" } } }]);
+const SessionCapabilityRequest = (0, record_js_1.defineRecord)('session.CapabilityRequest', [{ "name": "acceptInsecureCerts", "wire": "acceptInsecureCerts", "required": false, "type": { "primitive": "boolean" } }, { "name": "browserName", "wire": "browserName", "required": false, "type": { "primitive": "string" } }, { "name": "browserVersion", "wire": "browserVersion", "required": false, "type": { "primitive": "string" } }, { "name": "platformName", "wire": "platformName", "required": false, "type": { "primitive": "string" } }, { "name": "proxy", "wire": "proxy", "required": false, "type": { "ref": "session.ProxyConfiguration" } }, { "name": "unhandledPromptBehavior", "wire": "unhandledPromptBehavior", "required": false, "type": { "ref": "session.UserPromptHandler" } }], { "extensible": true });
+const SessionProxyConfigurationUnion = (0, union_js_1.defineUnion)('session.ProxyConfiguration', { "by": "proxyType", "variants": [{ "value": "autodetect", "ref": "session.AutodetectProxyConfiguration" }, { "value": "direct", "ref": "session.DirectProxyConfiguration" }, { "value": "manual", "ref": "session.ManualProxyConfiguration" }, { "value": "pac", "ref": "session.PacProxyConfiguration" }, { "value": "system", "ref": "session.SystemProxyConfiguration" }] }, { "objectOnly": true });
+const SessionAutodetectProxyConfiguration = (0, record_js_1.defineRecord)('session.AutodetectProxyConfiguration', [{ "name": "proxyType", "wire": "proxyType", "required": true, "type": { "const": "autodetect" } }], { "extensible": true });
+const SessionDirectProxyConfiguration = (0, record_js_1.defineRecord)('session.DirectProxyConfiguration', [{ "name": "proxyType", "wire": "proxyType", "required": true, "type": { "const": "direct" } }], { "extensible": true });
+const SessionManualProxyConfiguration = (0, record_js_1.defineRecord)('session.ManualProxyConfiguration', [{ "name": "proxyType", "wire": "proxyType", "required": true, "type": { "const": "manual" } }, { "name": "httpProxy", "wire": "httpProxy", "required": false, "type": { "primitive": "string" } }, { "name": "sslProxy", "wire": "sslProxy", "required": false, "type": { "primitive": "string" } }, { "name": "socksProxy", "wire": "socksProxy", "required": true, "type": { "primitive": "string" } }, { "name": "socksVersion", "wire": "socksVersion", "required": true, "type": { "primitive": "integer" } }, { "name": "noProxy", "wire": "noProxy", "required": false, "type": { "list": { "primitive": "string" } } }], { "extensible": true });
+const SessionSocksProxyConfiguration = (0, record_js_1.defineRecord)('session.SocksProxyConfiguration', [{ "name": "socksProxy", "wire": "socksProxy", "required": true, "type": { "primitive": "string" } }, { "name": "socksVersion", "wire": "socksVersion", "required": true, "type": { "primitive": "integer" } }]);
+const SessionPacProxyConfiguration = (0, record_js_1.defineRecord)('session.PacProxyConfiguration', [{ "name": "proxyType", "wire": "proxyType", "required": true, "type": { "const": "pac" } }, { "name": "proxyAutoconfigUrl", "wire": "proxyAutoconfigUrl", "required": true, "type": { "primitive": "string" } }], { "extensible": true });
+const SessionSystemProxyConfiguration = (0, record_js_1.defineRecord)('session.SystemProxyConfiguration', [{ "name": "proxyType", "wire": "proxyType", "required": true, "type": { "const": "system" } }], { "extensible": true });
+const SessionUserPromptHandler = (0, record_js_1.defineRecord)('session.UserPromptHandler', [{ "name": "alert", "wire": "alert", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }, { "name": "beforeUnload", "wire": "beforeUnload", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }, { "name": "confirm", "wire": "confirm", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }, { "name": "default", "wire": "default", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }, { "name": "file", "wire": "file", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }, { "name": "prompt", "wire": "prompt", "required": false, "type": { "ref": "session.UserPromptHandlerType" } }]);
+const SessionUserPromptHandlerTypeEnum = (0, enum_js_1.defineEnum)('session.UserPromptHandlerType', ["accept", "dismiss", "ignore"]);
+(0, record_js_1.defineAlias)('session.Subscription', { "primitive": "string" });
+const SessionSubscribeParameters = (0, record_js_1.defineRecord)('session.SubscribeParameters', [{ "name": "events", "wire": "events", "required": true, "type": { "list": { "primitive": "string" } } }, { "name": "contexts", "wire": "contexts", "required": false, "type": { "list": { "ref": "browsingContext.BrowsingContext" } } }, { "name": "userContexts", "wire": "userContexts", "required": false, "type": { "list": { "ref": "browser.UserContext" } } }]);
+const SessionUnsubscribeByIdRequest = (0, record_js_1.defineRecord)('session.UnsubscribeByIDRequest', [{ "name": "subscriptions", "wire": "subscriptions", "required": true, "type": { "list": { "ref": "session.Subscription" } } }]);
+const SessionUnsubscribeByAttributesRequest = (0, record_js_1.defineRecord)('session.UnsubscribeByAttributesRequest', [{ "name": "events", "wire": "events", "required": true, "type": { "list": { "primitive": "string" } } }]);
+const SessionStatus = (0, record_js_1.defineRecord)('session.Status', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "session.status" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "EmptyParams" } }]);
+const SessionStatusResult = (0, record_js_1.defineRecord)('session.StatusResult', [{ "name": "ready", "wire": "ready", "required": true, "type": { "primitive": "boolean" } }, { "name": "message", "wire": "message", "required": true, "type": { "primitive": "string" } }]);
+const SessionNew = (0, record_js_1.defineRecord)('session.New', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "session.new" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "session.NewParameters" } }]);
+const SessionNewParameters = (0, record_js_1.defineRecord)('session.NewParameters', [{ "name": "capabilities", "wire": "capabilities", "required": true, "type": { "ref": "session.CapabilitiesRequest" } }]);
+const SessionNewResult = (0, record_js_1.defineRecord)('session.NewResult', [{ "name": "sessionId", "wire": "sessionId", "required": true, "type": { "primitive": "string" } }, { "name": "capabilities", "wire": "capabilities", "required": true, "type": { "ref": "session.NewResultCapabilities" } }]);
+const SessionEnd = (0, record_js_1.defineRecord)('session.End', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "session.end" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "EmptyParams" } }]);
+(0, record_js_1.defineAlias)('session.EndResult', { "ref": "EmptyResult" });
+const SessionSubscribe = (0, record_js_1.defineRecord)('session.Subscribe', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "session.subscribe" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "session.SubscribeParameters" } }]);
+const SessionSubscribeResult = (0, record_js_1.defineRecord)('session.SubscribeResult', [{ "name": "subscription", "wire": "subscription", "required": true, "type": { "ref": "session.Subscription" } }]);
+const SessionUnsubscribe = (0, record_js_1.defineRecord)('session.Unsubscribe', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "session.unsubscribe" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "session.UnsubscribeParameters" } }]);
+const SessionUnsubscribeParametersUnion = (0, union_js_1.defineUnion)('session.UnsubscribeParameters', { "ordered": [{ "ref": "session.UnsubscribeByAttributesRequest", "requires": ["events"] }, { "ref": "session.UnsubscribeByIDRequest", "requires": ["subscriptions"] }] }, { "objectOnly": true });
+(0, record_js_1.defineAlias)('session.UnsubscribeResult', { "ref": "EmptyResult" });
+const SessionNewResultCapabilities = (0, record_js_1.defineRecord)('session.NewResultCapabilities', [{ "name": "acceptInsecureCerts", "wire": "acceptInsecureCerts", "required": true, "type": { "primitive": "boolean" } }, { "name": "browserName", "wire": "browserName", "required": true, "type": { "primitive": "string" } }, { "name": "browserVersion", "wire": "browserVersion", "required": true, "type": { "primitive": "string" } }, { "name": "platformName", "wire": "platformName", "required": true, "type": { "primitive": "string" } }, { "name": "setWindowRect", "wire": "setWindowRect", "required": true, "type": { "primitive": "boolean" } }, { "name": "userAgent", "wire": "userAgent", "required": true, "type": { "primitive": "string" } }, { "name": "proxy", "wire": "proxy", "required": false, "type": { "ref": "session.ProxyConfiguration" } }, { "name": "unhandledPromptBehavior", "wire": "unhandledPromptBehavior", "required": false, "type": { "ref": "session.UserPromptHandler" } }, { "name": "webSocketUrl", "wire": "webSocketUrl", "required": false, "type": { "primitive": "string" } }], { "extensible": true });
 // --- Implementation ---
-class Session {
-    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 Session 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 Session(bidi);
+        return new Session(await domain_js_1.Domain.connect(driver), domain_js_1.DOMAIN_TOKEN);
     }
+    /**
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-session-end
+     */
     async end() {
-        const response = await this.bidi.send({
-            method: 'session.end',
-            params: {},
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
+        await this.send('session.end', {});
     }
+    /**
+     * @param {SessionNewParameters} params
+     * @param {SessionCapabilitiesRequest} params.capabilities
+     * @returns {Promise<SessionNewResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-session-new
+     */
     async new(params) {
-        const response = await this.bidi.send({
-            method: 'session.new',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new SessionNewParameters(params);
+        const result = await this.send('session.new', validatedParams);
+        return SessionNewResult.fromWire(result);
     }
+    /**
+     * @returns {Promise<SessionStatusResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-session-status
+     */
     async status() {
-        const response = await this.bidi.send({
-            method: 'session.status',
-            params: {},
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const result = await this.send('session.status', {});
+        return SessionStatusResult.fromWire(result);
     }
+    /**
+     * @param {SessionSubscribeParameters} params
+     * @param {Array<string>} params.events
+     * @param {Array<BrowsingContextBrowsingContext>} [params.contexts]
+     * @param {Array<BrowserUserContext>} [params.userContexts]
+     * @returns {Promise<SessionSubscribeResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-session-subscribe
+     */
     async subscribe(params) {
-        const response = await this.bidi.send({
-            method: 'session.subscribe',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new SessionSubscribeParameters(params);
+        const result = await this.send('session.subscribe', validatedParams);
+        return SessionSubscribeResult.fromWire(result);
     }
+    /**
+     * @param {SessionUnsubscribeParameters} params
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-session-unsubscribe
+     */
     async unsubscribe(params) {
-        const response = await this.bidi.send({
-            method: 'session.unsubscribe',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
+        const validatedParams = SessionUnsubscribeParametersUnion.build(params);
+        await this.send('session.unsubscribe', validatedParams);
     }
 }
 exports.Session = Session;
+Session.UserPromptHandlerType = Object.freeze({ ACCEPT: "accept", DISMISS: "dismiss", IGNORE: "ignore" });

package/bidi/generated/speculation.d.ts

@@ -1,5 +1,5 @@
+import { Domain, type EventDescriptor } from '../domain.js';
 export type SpeculationPreloadingStatus = "pending" | "ready" | "success" | "failure";
-export type SpeculationEvent = SpeculationPrefetchStatusUpdated;
 export interface SpeculationPrefetchStatusUpdated {
     method: "speculation.prefetchStatusUpdated";
     params: SpeculationPrefetchStatusUpdatedParameters;
@@ -9,9 +9,19 @@ export interface SpeculationPrefetchStatusUpdatedParameters {
     url: string;
     status: SpeculationPreloadingStatus;
 }
-export declare class Speculation {
-    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 Speculation extends Domain {
+    /** @see https://w3c.github.io/webdriver-bidi/#event-speculation-prefetchStatusUpdated */
+    static readonly PREFETCH_STATUS_UPDATED: EventDescriptor<SpeculationPrefetchStatusUpdatedParameters>;
+    static readonly PreloadingStatus: Readonly<{
+        readonly PENDING: "pending";
+        readonly READY: "ready";
+        readonly SUCCESS: "success";
+        readonly FAILURE: "failure";
+    }>;
     static create(driver: unknown): Promise<Speculation>;
-    onPrefetchStatusUpdated(callback: (params: SpeculationPrefetchStatusUpdatedParameters) => void): Promise<void>;
 }

package/bidi/generated/speculation.js

@@ -17,24 +17,28 @@
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Speculation = void 0;
+// DO NOT EDIT! This file is generated by javascript/selenium-webdriver/generate_bidi.mjs.
+// Regenerate with: `bazel build //javascript/selenium-webdriver:create-bidi-src`
+// Built from the WebDriver BiDi CDDL spec (v1.0).
+// Source: https://github.com/w3c/webref/tree/main/ed/cddl
+const record_js_1 = require("../serialization/record.js");
+const enum_js_1 = require("../serialization/enum.js");
+const domain_js_1 = require("../domain.js");
+const SpeculationPreloadingStatusEnum = (0, enum_js_1.defineEnum)('speculation.PreloadingStatus', ["pending", "ready", "success", "failure"]);
+const SpeculationPrefetchStatusUpdated = (0, record_js_1.defineRecord)('speculation.PrefetchStatusUpdated', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "speculation.prefetchStatusUpdated" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "speculation.PrefetchStatusUpdatedParameters" } }]);
+const SpeculationPrefetchStatusUpdatedParameters = (0, record_js_1.defineRecord)('speculation.PrefetchStatusUpdatedParameters', [{ "name": "context", "wire": "context", "required": true, "type": { "primitive": "string" } }, { "name": "url", "wire": "url", "required": true, "type": { "primitive": "string" } }, { "name": "status", "wire": "status", "required": true, "type": { "ref": "speculation.PreloadingStatus" } }]);
 // --- Implementation ---
-class Speculation {
-    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 Speculation 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 Speculation(bidi);
-    }
-    async onPrefetchStatusUpdated(callback) {
-        await this.bidi.subscribe('speculation.prefetchStatusUpdated');
-        this.bidi.on('speculation.prefetchStatusUpdated', (params) => {
-            callback(params);
-        });
+        return new Speculation(await domain_js_1.Domain.connect(driver), domain_js_1.DOMAIN_TOKEN);
     }
 }
 exports.Speculation = Speculation;
+/** @see https://w3c.github.io/webdriver-bidi/#event-speculation-prefetchStatusUpdated */
+Speculation.PREFETCH_STATUS_UPDATED = (0, domain_js_1.event)('speculation.prefetchStatusUpdated', SpeculationPrefetchStatusUpdatedParameters);
+Speculation.PreloadingStatus = Object.freeze({ PENDING: "pending", READY: "ready", SUCCESS: "success", FAILURE: "failure" });

package/bidi/generated/storage.d.ts

@@ -1,17 +1,19 @@
 import type { BrowsingContextBrowsingContext } from './browsing_context.js';
-import type { Extensible, JsUint } from './common.js';
+import './browsing_context.js';
+import type { JsUint } from './common.js';
+import './common.js';
 import type { NetworkBytesValue, NetworkCookie, NetworkSameSite } from './network.js';
-export type StorageCommand = StorageDeleteCookies | StorageGetCookies | StorageSetCookie;
-export type StorageResult = StorageDeleteCookiesResult | StorageGetCookiesResult | StorageSetCookieResult;
-export type StoragePartitionKey = Extensible & {
+import './network.js';
+import { Domain } from '../domain.js';
+export interface StoragePartitionKey {
     userContext?: string;
     sourceOrigin?: string;
-};
+}
 export interface StorageGetCookies {
     method: "storage.getCookies";
     params: StorageGetCookiesParameters;
 }
-export type StorageCookieFilter = Extensible & {
+export interface StorageCookieFilter {
     name?: string;
     value?: NetworkBytesValue;
     domain?: string;
@@ -21,30 +23,30 @@ export type StorageCookieFilter = Extensible & {
     secure?: boolean;
     sameSite?: NetworkSameSite;
     expiry?: JsUint;
-};
+}
 export interface StorageBrowsingContextPartitionDescriptor {
     type: "context";
     context: BrowsingContextBrowsingContext;
 }
-export type StorageStorageKeyPartitionDescriptor = Extensible & {
+export interface StorageStorageKeyPartitionDescriptor {
     type: "storageKey";
     userContext?: string;
     sourceOrigin?: string;
-};
+}
 export type StoragePartitionDescriptor = StorageBrowsingContextPartitionDescriptor | StorageStorageKeyPartitionDescriptor;
 export interface StorageGetCookiesParameters {
     filter?: StorageCookieFilter;
     partition?: StoragePartitionDescriptor;
 }
 export interface StorageGetCookiesResult {
-    cookies: NetworkCookie[];
+    cookies: Array<NetworkCookie>;
     partitionKey: StoragePartitionKey;
 }
 export interface StorageSetCookie {
     method: "storage.setCookie";
     params: StorageSetCookieParameters;
 }
-export type StoragePartialCookie = Extensible & {
+export interface StoragePartialCookie {
     name: string;
     value: NetworkBytesValue;
     domain: string;
@@ -53,7 +55,7 @@ export type StoragePartialCookie = Extensible & {
     secure?: boolean;
     sameSite?: NetworkSameSite;
     expiry?: JsUint;
-};
+}
 export interface StorageSetCookieParameters {
     cookie: StoragePartialCookie;
     partition?: StoragePartitionDescriptor;
@@ -72,13 +74,35 @@ export interface StorageDeleteCookiesParameters {
 export interface StorageDeleteCookiesResult {
     partitionKey: StoragePartitionKey;
 }
-/** @deprecated Use {@link Storage.create} instead — will be removed in a future major version. */
-export declare function getStorageInstance(driver: unknown): Promise<Storage>;
-export declare class Storage {
-    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 Storage extends Domain {
     static create(driver: unknown): Promise<Storage>;
+    /**
+     * @param {StorageDeleteCookiesParameters} params
+     * @param {StorageCookieFilter} [params.filter]
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageDeleteCookiesResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-deleteCookies
+     */
     deleteCookies(params: StorageDeleteCookiesParameters): Promise<StorageDeleteCookiesResult>;
+    /**
+     * @param {StorageGetCookiesParameters} params
+     * @param {StorageCookieFilter} [params.filter]
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageGetCookiesResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-getCookies
+     */
     getCookies(params: StorageGetCookiesParameters): Promise<StorageGetCookiesResult>;
+    /**
+     * @param {StorageSetCookieParameters} params
+     * @param {StoragePartialCookie} params.cookie
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageSetCookieResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-setCookie
+     */
     setCookie(params: StorageSetCookieParameters): Promise<StorageSetCookieResult>;
 }

package/bidi/generated/storage.js

@@ -17,54 +17,72 @@
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 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);
-}
+require("./browsing_context.js");
+require("./common.js");
+require("./network.js");
+const record_js_1 = require("../serialization/record.js");
+const union_js_1 = require("../serialization/union.js");
+const domain_js_1 = require("../domain.js");
+const StoragePartitionKey = (0, record_js_1.defineRecord)('storage.PartitionKey', [{ "name": "userContext", "wire": "userContext", "required": false, "type": { "primitive": "string" } }, { "name": "sourceOrigin", "wire": "sourceOrigin", "required": false, "type": { "primitive": "string" } }], { "extensible": true });
+const StorageGetCookies = (0, record_js_1.defineRecord)('storage.GetCookies', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "storage.getCookies" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "storage.GetCookiesParameters" } }]);
+const StorageCookieFilter = (0, record_js_1.defineRecord)('storage.CookieFilter', [{ "name": "name", "wire": "name", "required": false, "type": { "primitive": "string" } }, { "name": "value", "wire": "value", "required": false, "type": { "ref": "network.BytesValue" } }, { "name": "domain", "wire": "domain", "required": false, "type": { "primitive": "string" } }, { "name": "path", "wire": "path", "required": false, "type": { "primitive": "string" } }, { "name": "size", "wire": "size", "required": false, "type": { "ref": "js-uint" } }, { "name": "httpOnly", "wire": "httpOnly", "required": false, "type": { "primitive": "boolean" } }, { "name": "secure", "wire": "secure", "required": false, "type": { "primitive": "boolean" } }, { "name": "sameSite", "wire": "sameSite", "required": false, "type": { "ref": "network.SameSite" } }, { "name": "expiry", "wire": "expiry", "required": false, "type": { "ref": "js-uint" } }], { "extensible": true });
+const StorageBrowsingContextPartitionDescriptor = (0, record_js_1.defineRecord)('storage.BrowsingContextPartitionDescriptor', [{ "name": "type", "wire": "type", "required": true, "type": { "const": "context" } }, { "name": "context", "wire": "context", "required": true, "type": { "ref": "browsingContext.BrowsingContext" } }]);
+const StorageStorageKeyPartitionDescriptor = (0, record_js_1.defineRecord)('storage.StorageKeyPartitionDescriptor', [{ "name": "type", "wire": "type", "required": true, "type": { "const": "storageKey" } }, { "name": "userContext", "wire": "userContext", "required": false, "type": { "primitive": "string" } }, { "name": "sourceOrigin", "wire": "sourceOrigin", "required": false, "type": { "primitive": "string" } }], { "extensible": true });
+const StoragePartitionDescriptorUnion = (0, union_js_1.defineUnion)('storage.PartitionDescriptor', { "by": "type", "variants": [{ "value": "context", "ref": "storage.BrowsingContextPartitionDescriptor" }, { "value": "storageKey", "ref": "storage.StorageKeyPartitionDescriptor" }] }, { "objectOnly": true });
+const StorageGetCookiesParameters = (0, record_js_1.defineRecord)('storage.GetCookiesParameters', [{ "name": "filter", "wire": "filter", "required": false, "type": { "ref": "storage.CookieFilter" } }, { "name": "partition", "wire": "partition", "required": false, "type": { "ref": "storage.PartitionDescriptor" } }]);
+const StorageGetCookiesResult = (0, record_js_1.defineRecord)('storage.GetCookiesResult', [{ "name": "cookies", "wire": "cookies", "required": true, "type": { "list": { "ref": "network.Cookie" } } }, { "name": "partitionKey", "wire": "partitionKey", "required": true, "type": { "ref": "storage.PartitionKey" } }]);
+const StorageSetCookie = (0, record_js_1.defineRecord)('storage.SetCookie', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "storage.setCookie" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "storage.SetCookieParameters" } }]);
+const StoragePartialCookie = (0, record_js_1.defineRecord)('storage.PartialCookie', [{ "name": "name", "wire": "name", "required": true, "type": { "primitive": "string" } }, { "name": "value", "wire": "value", "required": true, "type": { "ref": "network.BytesValue" } }, { "name": "domain", "wire": "domain", "required": true, "type": { "primitive": "string" } }, { "name": "path", "wire": "path", "required": false, "type": { "primitive": "string" } }, { "name": "httpOnly", "wire": "httpOnly", "required": false, "type": { "primitive": "boolean" } }, { "name": "secure", "wire": "secure", "required": false, "type": { "primitive": "boolean" } }, { "name": "sameSite", "wire": "sameSite", "required": false, "type": { "ref": "network.SameSite" } }, { "name": "expiry", "wire": "expiry", "required": false, "type": { "ref": "js-uint" } }], { "extensible": true });
+const StorageSetCookieParameters = (0, record_js_1.defineRecord)('storage.SetCookieParameters', [{ "name": "cookie", "wire": "cookie", "required": true, "type": { "ref": "storage.PartialCookie" } }, { "name": "partition", "wire": "partition", "required": false, "type": { "ref": "storage.PartitionDescriptor" } }]);
+const StorageSetCookieResult = (0, record_js_1.defineRecord)('storage.SetCookieResult', [{ "name": "partitionKey", "wire": "partitionKey", "required": true, "type": { "ref": "storage.PartitionKey" } }]);
+const StorageDeleteCookies = (0, record_js_1.defineRecord)('storage.DeleteCookies', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "storage.deleteCookies" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "storage.DeleteCookiesParameters" } }]);
+const StorageDeleteCookiesParameters = (0, record_js_1.defineRecord)('storage.DeleteCookiesParameters', [{ "name": "filter", "wire": "filter", "required": false, "type": { "ref": "storage.CookieFilter" } }, { "name": "partition", "wire": "partition", "required": false, "type": { "ref": "storage.PartitionDescriptor" } }]);
+const StorageDeleteCookiesResult = (0, record_js_1.defineRecord)('storage.DeleteCookiesResult', [{ "name": "partitionKey", "wire": "partitionKey", "required": true, "type": { "ref": "storage.PartitionKey" } }]);
 // --- Implementation ---
-class Storage {
-    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 Storage 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 Storage(bidi);
+        return new Storage(await domain_js_1.Domain.connect(driver), domain_js_1.DOMAIN_TOKEN);
     }
+    /**
+     * @param {StorageDeleteCookiesParameters} params
+     * @param {StorageCookieFilter} [params.filter]
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageDeleteCookiesResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-deleteCookies
+     */
     async deleteCookies(params) {
-        const response = await this.bidi.send({
-            method: 'storage.deleteCookies',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new StorageDeleteCookiesParameters(params);
+        const result = await this.send('storage.deleteCookies', validatedParams);
+        return StorageDeleteCookiesResult.fromWire(result);
     }
+    /**
+     * @param {StorageGetCookiesParameters} params
+     * @param {StorageCookieFilter} [params.filter]
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageGetCookiesResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-getCookies
+     */
     async getCookies(params) {
-        const response = await this.bidi.send({
-            method: 'storage.getCookies',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new StorageGetCookiesParameters(params);
+        const result = await this.send('storage.getCookies', validatedParams);
+        return StorageGetCookiesResult.fromWire(result);
     }
+    /**
+     * @param {StorageSetCookieParameters} params
+     * @param {StoragePartialCookie} params.cookie
+     * @param {StoragePartitionDescriptor} [params.partition]
+     * @returns {Promise<StorageSetCookieResult>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-storage-setCookie
+     */
     async setCookie(params) {
-        const response = await this.bidi.send({
-            method: 'storage.setCookie',
-            params: params,
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
-        return response.result;
+        const validatedParams = new StorageSetCookieParameters(params);
+        const result = await this.send('storage.setCookie', validatedParams);
+        return StorageSetCookieResult.fromWire(result);
     }
 }
 exports.Storage = Storage;

package/bidi/generated/user_agent_client_hints.d.ts

@@ -1,15 +1,11 @@
-export type UserAgentClientHintsCommand = UserAgentClientHintsSetClientHintsOverrideCommand;
+import { Domain } from '../domain.js';
 export interface UserAgentClientHintsSetClientHintsOverrideCommand {
     method: "userAgentClientHints.setClientHintsOverride";
-    params: {
-        clientHints: UserAgentClientHintsClientHintsMetadata | null;
-        contexts?: string[];
-        userContexts?: string[];
-    };
+    params: UserAgentClientHintsSetClientHintsOverrideCommandParams;
 }
 export interface UserAgentClientHintsClientHintsMetadata {
-    brands?: UserAgentClientHintsBrandVersion[];
-    fullVersionList?: UserAgentClientHintsBrandVersion[];
+    brands?: Array<UserAgentClientHintsBrandVersion>;
+    fullVersionList?: Array<UserAgentClientHintsBrandVersion>;
     platform?: string;
     platformVersion?: string;
     architecture?: string;
@@ -17,7 +13,7 @@ export interface UserAgentClientHintsClientHintsMetadata {
     mobile?: boolean;
     bitness?: string;
     wow64?: boolean;
-    formFactors?: string[];
+    formFactors?: Array<string>;
 }
 export interface UserAgentClientHintsBrandVersion {
     brand: string;
@@ -25,9 +21,25 @@ export interface UserAgentClientHintsBrandVersion {
 }
 export interface UserAgentClientHintsSetClientHintsOverrideResult {
 }
-export declare class UserAgentClientHints {
-    private readonly bidi;
-    private constructor();
+export interface UserAgentClientHintsSetClientHintsOverrideCommandParams {
+    clientHints: UserAgentClientHintsClientHintsMetadata | null;
+    contexts?: Array<string>;
+    userContexts?: Array<string>;
+}
+/**
+ * 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 UserAgentClientHints extends Domain {
     static create(driver: unknown): Promise<UserAgentClientHints>;
-    setClientHintsOverride(): Promise<void>;
+    /**
+     * @param {UserAgentClientHintsSetClientHintsOverrideCommandParams} params
+     * @param {UserAgentClientHintsClientHintsMetadata | null} params.clientHints
+     * @param {Array<string>} [params.contexts]
+     * @param {Array<string>} [params.userContexts]
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-userAgentClientHints-setClientHintsOverride
+     */
+    setClientHintsOverride(params: UserAgentClientHintsSetClientHintsOverrideCommandParams): Promise<void>;
 }

package/bidi/generated/user_agent_client_hints.js

@@ -17,27 +17,38 @@
 // under the License.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserAgentClientHints = void 0;
+// DO NOT EDIT! This file is generated by javascript/selenium-webdriver/generate_bidi.mjs.
+// Regenerate with: `bazel build //javascript/selenium-webdriver:create-bidi-src`
+// Built from the WebDriver BiDi CDDL spec (v1.0).
+// Source: https://github.com/w3c/webref/tree/main/ed/cddl
+const record_js_1 = require("../serialization/record.js");
+const domain_js_1 = require("../domain.js");
+const UserAgentClientHintsSetClientHintsOverrideCommand = (0, record_js_1.defineRecord)('userAgentClientHints.SetClientHintsOverrideCommand', [{ "name": "method", "wire": "method", "required": true, "type": { "const": "userAgentClientHints.setClientHintsOverride" } }, { "name": "params", "wire": "params", "required": true, "type": { "ref": "userAgentClientHints.SetClientHintsOverrideCommandParams" } }]);
+const UserAgentClientHintsClientHintsMetadata = (0, record_js_1.defineRecord)('userAgentClientHints.ClientHintsMetadata', [{ "name": "brands", "wire": "brands", "required": false, "type": { "list": { "ref": "userAgentClientHints.BrandVersion" } } }, { "name": "fullVersionList", "wire": "fullVersionList", "required": false, "type": { "list": { "ref": "userAgentClientHints.BrandVersion" } } }, { "name": "platform", "wire": "platform", "required": false, "type": { "primitive": "string" } }, { "name": "platformVersion", "wire": "platformVersion", "required": false, "type": { "primitive": "string" } }, { "name": "architecture", "wire": "architecture", "required": false, "type": { "primitive": "string" } }, { "name": "model", "wire": "model", "required": false, "type": { "primitive": "string" } }, { "name": "mobile", "wire": "mobile", "required": false, "type": { "primitive": "boolean" } }, { "name": "bitness", "wire": "bitness", "required": false, "type": { "primitive": "string" } }, { "name": "wow64", "wire": "wow64", "required": false, "type": { "primitive": "boolean" } }, { "name": "formFactors", "wire": "formFactors", "required": false, "type": { "list": { "primitive": "string" } } }]);
+const UserAgentClientHintsBrandVersion = (0, record_js_1.defineRecord)('userAgentClientHints.BrandVersion', [{ "name": "brand", "wire": "brand", "required": true, "type": { "primitive": "string" } }, { "name": "version", "wire": "version", "required": true, "type": { "primitive": "string" } }]);
+const UserAgentClientHintsSetClientHintsOverrideResult = (0, record_js_1.defineRecord)('userAgentClientHints.SetClientHintsOverrideResult', []);
+const UserAgentClientHintsSetClientHintsOverrideCommandParams = (0, record_js_1.defineRecord)('userAgentClientHints.SetClientHintsOverrideCommandParams', [{ "name": "clientHints", "wire": "clientHints", "required": true, "type": { "ref": "userAgentClientHints.ClientHintsMetadata", "nullable": true } }, { "name": "contexts", "wire": "contexts", "required": false, "type": { "list": { "primitive": "string" } } }, { "name": "userContexts", "wire": "userContexts", "required": false, "type": { "list": { "primitive": "string" } } }]);
 // --- Implementation ---
-class UserAgentClientHints {
-    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 UserAgentClientHints 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 UserAgentClientHints(bidi);
+        return new UserAgentClientHints(await domain_js_1.Domain.connect(driver), domain_js_1.DOMAIN_TOKEN);
     }
-    async setClientHintsOverride() {
-        const response = await this.bidi.send({
-            method: 'userAgentClientHints.setClientHintsOverride',
-            params: {},
-        });
-        if (response['type'] === 'error') {
-            throw new Error(`${response['error']}: ${response['message']}`);
-        }
+    /**
+     * @param {UserAgentClientHintsSetClientHintsOverrideCommandParams} params
+     * @param {UserAgentClientHintsClientHintsMetadata | null} params.clientHints
+     * @param {Array<string>} [params.contexts]
+     * @param {Array<string>} [params.userContexts]
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-userAgentClientHints-setClientHintsOverride
+     */
+    async setClientHintsOverride(params) {
+        const validatedParams = new UserAgentClientHintsSetClientHintsOverrideCommandParams(params);
+        await this.send('userAgentClientHints.setClientHintsOverride', validatedParams);
     }
 }
 exports.UserAgentClientHints = UserAgentClientHints;