selenium-webdriver 4.43.0 → 4.45.0

package/bidi/generated/bluetooth.js

@@ -0,0 +1,154 @@
+"use strict";
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Bluetooth = void 0;
+// --- Implementation ---
+class Bluetooth {
+    constructor(bidi) {
+        this.bidi = bidi;
+    }
+    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 Bluetooth(bidi);
+    }
+    async handleRequestDevicePrompt(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.handleRequestDevicePrompt',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateAdapter(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateAdapter',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async disableSimulation(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.disableSimulation',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulatePreconnectedPeripheral(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulatePreconnectedPeripheral',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateAdvertisement(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateAdvertisement',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateGattConnectionResponse(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateGattConnectionResponse',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateGattDisconnection(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateGattDisconnection',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateService(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateService',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateCharacteristic(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateCharacteristic',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateCharacteristicResponse(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateCharacteristicResponse',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateDescriptor(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateDescriptor',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async simulateDescriptorResponse(params) {
+        const response = await this.bidi.send({
+            method: 'bluetooth.simulateDescriptorResponse',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async onRequestDevicePromptUpdated(callback) {
+        await this.bidi.subscribe('bluetooth.requestDevicePromptUpdated');
+        this.bidi.on('bluetooth.requestDevicePromptUpdated', (params) => {
+            callback(params);
+        });
+    }
+    async onGattConnectionAttempted(callback) {
+        await this.bidi.subscribe('bluetooth.gattConnectionAttempted');
+        this.bidi.on('bluetooth.gattConnectionAttempted', (params) => {
+            callback(params);
+        });
+    }
+}
+exports.Bluetooth = Bluetooth;

package/bidi/generated/browser.d.ts

@@ -0,0 +1,104 @@
+import type { EmptyParams, EmptyResult, JsInt, JsUint } from './common.js';
+import type { SessionProxyConfiguration, SessionUserPromptHandler } from './session.js';
+export type BrowserCommand = BrowserClose | BrowserCreateUserContext | BrowserGetClientWindows | BrowserGetUserContexts | BrowserRemoveUserContext | BrowserSetClientWindowState | BrowserSetDownloadBehavior;
+export type BrowserResult = BrowserCloseResult | BrowserCreateUserContextResult | BrowserGetClientWindowsResult | BrowserGetUserContextsResult | BrowserRemoveUserContextResult | BrowserSetClientWindowStateResult | BrowserSetDownloadBehaviorResult;
+export type BrowserClientWindow = string;
+export interface BrowserClientWindowInfo {
+    active: boolean;
+    clientWindow: BrowserClientWindow;
+    height: JsUint;
+    state: "fullscreen" | "maximized" | "minimized" | "normal";
+    width: JsUint;
+    x: JsInt;
+    y: JsInt;
+}
+export type BrowserUserContext = string;
+export interface BrowserUserContextInfo {
+    userContext: BrowserUserContext;
+}
+export interface BrowserClose {
+    method: "browser.close";
+    params: EmptyParams;
+}
+export type BrowserCloseResult = EmptyResult;
+export interface BrowserCreateUserContext {
+    method: "browser.createUserContext";
+    params: BrowserCreateUserContextParameters;
+}
+export interface BrowserCreateUserContextParameters {
+    acceptInsecureCerts?: boolean;
+    proxy?: SessionProxyConfiguration;
+    unhandledPromptBehavior?: SessionUserPromptHandler;
+}
+export type BrowserCreateUserContextResult = BrowserUserContextInfo;
+export interface BrowserGetClientWindows {
+    method: "browser.getClientWindows";
+    params: EmptyParams;
+}
+export interface BrowserGetClientWindowsResult {
+    clientWindows: BrowserClientWindowInfo[];
+}
+export interface BrowserGetUserContexts {
+    method: "browser.getUserContexts";
+    params: EmptyParams;
+}
+export interface BrowserGetUserContextsResult {
+    userContexts: BrowserUserContextInfo[];
+}
+export interface BrowserRemoveUserContext {
+    method: "browser.removeUserContext";
+    params: BrowserRemoveUserContextParameters;
+}
+export interface BrowserRemoveUserContextParameters {
+    userContext: BrowserUserContext;
+}
+export type BrowserRemoveUserContextResult = EmptyResult;
+export interface BrowserSetClientWindowState {
+    method: "browser.setClientWindowState";
+    params: BrowserSetClientWindowStateParameters;
+}
+export type BrowserSetClientWindowStateParameters = (BrowserClientWindowNamedState | BrowserClientWindowRectState) & {
+    clientWindow: BrowserClientWindow;
+};
+export interface BrowserClientWindowNamedState {
+    state: "fullscreen" | "maximized" | "minimized";
+}
+export interface BrowserClientWindowRectState {
+    state: "normal";
+    width?: JsUint;
+    height?: JsUint;
+    x?: JsInt;
+    y?: JsInt;
+}
+export type BrowserSetClientWindowStateResult = BrowserClientWindowInfo;
+export interface BrowserSetDownloadBehavior {
+    method: "browser.setDownloadBehavior";
+    params: BrowserSetDownloadBehaviorParameters;
+}
+export interface BrowserSetDownloadBehaviorParameters {
+    downloadBehavior: BrowserDownloadBehavior | null;
+    userContexts?: BrowserUserContext[];
+}
+export type BrowserDownloadBehavior = (BrowserDownloadBehaviorAllowed | BrowserDownloadBehaviorDenied);
+export interface BrowserDownloadBehaviorAllowed {
+    type: "allowed";
+    destinationFolder: string;
+}
+export interface BrowserDownloadBehaviorDenied {
+    type: "denied";
+}
+export type BrowserSetDownloadBehaviorResult = EmptyResult;
+/** @deprecated Use {@link Browser.create} instead — will be removed in a future major version. */
+export declare function getBrowserInstance(driver: unknown): Promise<Browser>;
+export declare class Browser {
+    private readonly bidi;
+    private constructor();
+    static create(driver: unknown): Promise<Browser>;
+    close(): Promise<void>;
+    createUserContext(params: BrowserCreateUserContextParameters): Promise<BrowserCreateUserContextResult>;
+    getClientWindows(): Promise<BrowserGetClientWindowsResult>;
+    getUserContexts(): Promise<BrowserGetUserContextsResult>;
+    removeUserContext(params: BrowserRemoveUserContextParameters): Promise<void>;
+    setClientWindowState(params: BrowserSetClientWindowStateParameters): Promise<BrowserSetClientWindowStateResult>;
+    setDownloadBehavior(params: BrowserSetDownloadBehaviorParameters): Promise<void>;
+}

package/bidi/generated/browser.js

@@ -0,0 +1,107 @@
+"use strict";
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Browser = exports.getBrowserInstance = void 0;
+// --- 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) {
+        this.bidi = bidi;
+    }
+    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 Browser(bidi);
+    }
+    async close() {
+        const response = await this.bidi.send({
+            method: 'browser.close',
+            params: {},
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async createUserContext(params) {
+        const response = await this.bidi.send({
+            method: 'browser.createUserContext',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
+    async getClientWindows() {
+        const response = await this.bidi.send({
+            method: 'browser.getClientWindows',
+            params: {},
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
+    async getUserContexts() {
+        const response = await this.bidi.send({
+            method: 'browser.getUserContexts',
+            params: {},
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
+    async removeUserContext(params) {
+        const response = await this.bidi.send({
+            method: 'browser.removeUserContext',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setClientWindowState(params) {
+        const response = await this.bidi.send({
+            method: 'browser.setClientWindowState',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+        return response.result;
+    }
+    async setDownloadBehavior(params) {
+        const response = await this.bidi.send({
+            method: 'browser.setDownloadBehavior',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+}
+exports.Browser = Browser;