selenium-webdriver 4.44.0 → 4.45.0

package/bidi/generated/common.js

@@ -0,0 +1,30 @@
+"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 });
+// Minimum size is 1pt x 1pt. Conversion follows from
+// https://www.w3.org/TR/css3-values/#absolute-lengths
+// Minimum size is 1pt x 1pt. Conversion follows from
+// https://www.w3.org/TR/css3-values/#absolute-lengths
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)
+// Content was automatically extracted by Reffy into webref
+// (https://github.com/w3c/webref)

package/bidi/generated/emulation.d.ts

@@ -0,0 +1,176 @@
+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 interface EmulationSetForcedColorsModeThemeOverride {
+    method: "emulation.setForcedColorsModeThemeOverride";
+    params: EmulationSetForcedColorsModeThemeOverrideParameters;
+}
+export interface EmulationSetForcedColorsModeThemeOverrideParameters {
+    theme: EmulationForcedColorsModeTheme | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationForcedColorsModeTheme = "light" | "dark";
+export type EmulationSetForcedColorsModeThemeOverrideResult = EmptyResult;
+export interface EmulationSetGeolocationOverride {
+    method: "emulation.setGeolocationOverride";
+    params: EmulationSetGeolocationOverrideParameters;
+}
+export type EmulationSetGeolocationOverrideParameters = ({
+    coordinates: EmulationGeolocationCoordinates | null;
+} | {
+    error: EmulationGeolocationPositionError;
+}) & {
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+};
+export interface EmulationGeolocationCoordinates {
+    latitude: number;
+    longitude: number;
+    /**
+     * @default 1
+     */
+    accuracy?: number;
+    /**
+     * @default null
+     */
+    altitude?: number | null;
+    /**
+     * @default null
+     */
+    altitudeAccuracy?: number | null;
+    /**
+     * @default null
+     */
+    heading?: number | null;
+    /**
+     * @default null
+     */
+    speed?: number | null;
+}
+export interface EmulationGeolocationPositionError {
+    type: "positionUnavailable";
+}
+export type EmulationSetGeolocationOverrideResult = EmptyResult;
+export interface EmulationSetLocaleOverride {
+    method: "emulation.setLocaleOverride";
+    params: EmulationSetLocaleOverrideParameters;
+}
+export interface EmulationSetLocaleOverrideParameters {
+    locale: string | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetLocaleOverrideResult = EmptyResult;
+export interface EmulationSetNetworkConditions {
+    method: "emulation.setNetworkConditions";
+    params: EmulationSetNetworkConditionsParameters;
+}
+export interface EmulationSetNetworkConditionsParameters {
+    networkConditions: EmulationNetworkConditions | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationNetworkConditions = EmulationNetworkConditionsOffline;
+export interface EmulationNetworkConditionsOffline {
+    type: "offline";
+}
+export type EmulationSetNetworkConditionsResult = EmptyResult;
+export interface EmulationSetScreenSettingsOverride {
+    method: "emulation.setScreenSettingsOverride";
+    params: EmulationSetScreenSettingsOverrideParameters;
+}
+export interface EmulationScreenArea {
+    width: JsUint;
+    height: JsUint;
+}
+export interface EmulationSetScreenSettingsOverrideParameters {
+    screenArea: EmulationScreenArea | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetScreenSettingsOverrideResult = EmptyResult;
+export interface EmulationSetScreenOrientationOverride {
+    method: "emulation.setScreenOrientationOverride";
+    params: EmulationSetScreenOrientationOverrideParameters;
+}
+export type EmulationScreenOrientationNatural = "portrait" | "landscape";
+export type EmulationScreenOrientationType = "portrait-primary" | "portrait-secondary" | "landscape-primary" | "landscape-secondary";
+export interface EmulationScreenOrientation {
+    natural: EmulationScreenOrientationNatural;
+    type: EmulationScreenOrientationType;
+}
+export interface EmulationSetScreenOrientationOverrideParameters {
+    screenOrientation: EmulationScreenOrientation | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetScreenOrientationOverrideResult = EmptyResult;
+export interface EmulationSetUserAgentOverride {
+    method: "emulation.setUserAgentOverride";
+    params: EmulationSetUserAgentOverrideParameters;
+}
+export interface EmulationSetUserAgentOverrideParameters {
+    userAgent: string | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetUserAgentOverrideResult = EmptyResult;
+export interface EmulationSetScriptingEnabled {
+    method: "emulation.setScriptingEnabled";
+    params: EmulationSetScriptingEnabledParameters;
+}
+export interface EmulationSetScriptingEnabledParameters {
+    enabled: false | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetScriptingEnabledResult = EmptyResult;
+export interface EmulationSetScrollbarTypeOverride {
+    method: "emulation.setScrollbarTypeOverride";
+    params: EmulationSetScrollbarTypeOverrideParameters;
+}
+export interface EmulationSetScrollbarTypeOverrideParameters {
+    scrollbarType: "classic" | "overlay" | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetScrollbarTypeOverrideResult = EmptyResult;
+export interface EmulationSetTimezoneOverride {
+    method: "emulation.setTimezoneOverride";
+    params: EmulationSetTimezoneOverrideParameters;
+}
+export interface EmulationSetTimezoneOverrideParameters {
+    timezone: string | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetTimezoneOverrideResult = EmptyResult;
+export interface EmulationSetTouchOverride {
+    method: "emulation.setTouchOverride";
+    params: EmulationSetTouchOverrideParameters;
+}
+export interface EmulationSetTouchOverrideParameters {
+    maxTouchPoints: JsUint | null;
+    contexts?: BrowsingContextBrowsingContext[];
+    userContexts?: BrowserUserContext[];
+}
+export type EmulationSetTouchOverrideResult = EmptyResult;
+export declare class Emulation {
+    private readonly bidi;
+    private constructor();
+    static create(driver: unknown): Promise<Emulation>;
+    setForcedColorsModeThemeOverride(params: EmulationSetForcedColorsModeThemeOverrideParameters): Promise<void>;
+    setGeolocationOverride(params: EmulationSetGeolocationOverrideParameters): Promise<void>;
+    setLocaleOverride(params: EmulationSetLocaleOverrideParameters): Promise<void>;
+    setNetworkConditions(params: EmulationSetNetworkConditionsParameters): Promise<void>;
+    setScreenOrientationOverride(params: EmulationSetScreenOrientationOverrideParameters): Promise<void>;
+    setScreenSettingsOverride(params: EmulationSetScreenSettingsOverrideParameters): Promise<void>;
+    setScriptingEnabled(params: EmulationSetScriptingEnabledParameters): Promise<void>;
+    setScrollbarTypeOverride(params: EmulationSetScrollbarTypeOverrideParameters): Promise<void>;
+    setTimezoneOverride(params: EmulationSetTimezoneOverrideParameters): Promise<void>;
+    setTouchOverride(params: EmulationSetTouchOverrideParameters): Promise<void>;
+    setUserAgentOverride(params: EmulationSetUserAgentOverrideParameters): Promise<void>;
+}

package/bidi/generated/emulation.js

@@ -0,0 +1,133 @@
+"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.Emulation = void 0;
+// --- Implementation ---
+class Emulation {
+    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 Emulation(bidi);
+    }
+    async setForcedColorsModeThemeOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setForcedColorsModeThemeOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setGeolocationOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setGeolocationOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setLocaleOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setLocaleOverride',
+            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',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setScreenOrientationOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setScreenOrientationOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setScreenSettingsOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setScreenSettingsOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setScriptingEnabled(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setScriptingEnabled',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setScrollbarTypeOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setScrollbarTypeOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setTimezoneOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setTimezoneOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setTouchOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setTouchOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setUserAgentOverride(params) {
+        const response = await this.bidi.send({
+            method: 'emulation.setUserAgentOverride',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+}
+exports.Emulation = Emulation;

package/bidi/generated/input.d.ts

@@ -0,0 +1,151 @@
+import type { BrowserUserContext } from './browser.js';
+import type { BrowsingContextBrowsingContext } from './browsing_context.js';
+import type { EmptyResult, JsInt, JsUint } from './common.js';
+import type { ScriptSharedReference } from './script.js';
+export type InputCommand = InputPerformActions | InputReleaseActions | InputSetFiles;
+export type InputResult = InputPerformActionsResult | InputReleaseActionsResult | InputSetFilesResult;
+export type InputEvent = InputFileDialogOpened;
+export interface InputElementOrigin {
+    type: "element";
+    element: ScriptSharedReference;
+}
+export interface InputPerformActions {
+    method: "input.performActions";
+    params: InputPerformActionsParameters;
+}
+export interface InputPerformActionsParameters {
+    context: BrowsingContextBrowsingContext;
+    actions: InputSourceActions[];
+}
+export type InputSourceActions = InputNoneSourceActions | InputKeySourceActions | InputPointerSourceActions | InputWheelSourceActions;
+export interface InputNoneSourceActions {
+    type: "none";
+    id: string;
+    actions: InputNoneSourceAction[];
+}
+export type InputNoneSourceAction = InputPauseAction;
+export interface InputKeySourceActions {
+    type: "key";
+    id: string;
+    actions: InputKeySourceAction[];
+}
+export type InputKeySourceAction = InputPauseAction | InputKeyDownAction | InputKeyUpAction;
+export interface InputPointerSourceActions {
+    type: "pointer";
+    id: string;
+    parameters?: InputPointerParameters;
+    actions: InputPointerSourceAction[];
+}
+export type InputPointerType = "mouse" | "pen" | "touch";
+export interface InputPointerParameters {
+    /**
+     * @default 'mouse'
+     */
+    pointerType?: InputPointerType;
+}
+export type InputPointerSourceAction = InputPauseAction | InputPointerDownAction | InputPointerUpAction | InputPointerMoveAction;
+export interface InputWheelSourceActions {
+    type: "wheel";
+    id: string;
+    actions: InputWheelSourceAction[];
+}
+export type InputWheelSourceAction = InputPauseAction | InputWheelScrollAction;
+export interface InputPauseAction {
+    type: "pause";
+    duration?: JsUint;
+}
+export interface InputKeyDownAction {
+    type: "keyDown";
+    value: string;
+}
+export interface InputKeyUpAction {
+    type: "keyUp";
+    value: string;
+}
+export interface InputPointerUpAction {
+    type: "pointerUp";
+    button: JsUint;
+}
+export type InputPointerDownAction = InputPointerCommonProperties & {
+    type: "pointerDown";
+    button: JsUint;
+};
+export type InputPointerMoveAction = InputPointerCommonProperties & {
+    type: "pointerMove";
+    x: number;
+    y: number;
+    duration?: JsUint;
+    origin?: InputOrigin;
+};
+export interface InputWheelScrollAction {
+    type: "scroll";
+    x: JsInt;
+    y: JsInt;
+    deltaX: JsInt;
+    deltaY: JsInt;
+    duration?: JsUint;
+    /**
+     * @default 'viewport'
+     */
+    origin?: InputOrigin;
+}
+export interface InputPointerCommonProperties {
+    width?: JsUint;
+    height?: JsUint;
+    pressure?: number;
+    tangentialPressure?: number;
+    /**
+     * 0 .. Math.PI / 2
+     */
+    twist?: number;
+    /**
+     * 0 .. 2 * Math.PI
+     */
+    altitudeAngle?: number;
+    azimuthAngle?: number;
+}
+export type InputOrigin = "viewport" | "pointer" | InputElementOrigin;
+export type InputPerformActionsResult = EmptyResult;
+export interface InputReleaseActions {
+    method: "input.releaseActions";
+    params: InputReleaseActionsParameters;
+}
+export interface InputReleaseActionsParameters {
+    context: BrowsingContextBrowsingContext;
+}
+export type InputReleaseActionsResult = EmptyResult;
+export interface InputSetFiles {
+    method: "input.setFiles";
+    params: InputSetFilesParameters;
+}
+export interface InputSetFilesParameters {
+    context: BrowsingContextBrowsingContext;
+    element: ScriptSharedReference;
+    files: string[];
+}
+export type InputSetFilesResult = EmptyResult;
+export interface InputFileDialogOpened {
+    method: "input.fileDialogOpened";
+    params: InputFileDialogInfo;
+}
+export interface InputFileDialogInfo {
+    context: BrowsingContextBrowsingContext;
+    userContext?: BrowserUserContext;
+    element?: ScriptSharedReference;
+    multiple: boolean;
+}
+/** @deprecated Use {@link Input.create} instead — will be removed in a future major version. */
+export declare function getInputInstance(driver: unknown): Promise<Input>;
+export declare class Input {
+    private readonly bidi;
+    private constructor();
+    static create(driver: unknown): Promise<Input>;
+    performActions(params: InputPerformActionsParameters): Promise<void>;
+    releaseActions(params: InputReleaseActionsParameters): Promise<void>;
+    setFiles(params: InputSetFilesParameters): Promise<void>;
+    onFileDialogOpened(callback: (params: InputFileDialogInfo) => void): Promise<void>;
+    /** @deprecated Use {@link performActions} instead — will be removed in a future major version. */
+    perform(browsingContextId: string, actions: InputSourceActions[]): Promise<void>;
+    /** @deprecated Use {@link releaseActions} instead — will be removed in a future major version. */
+    release(browsingContextId: string): Promise<void>;
+}

package/bidi/generated/input.js

@@ -0,0 +1,81 @@
+"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.Input = exports.getInputInstance = void 0;
+// --- 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) {
+        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 Input(bidi);
+    }
+    async performActions(params) {
+        const response = await this.bidi.send({
+            method: 'input.performActions',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async releaseActions(params) {
+        const response = await this.bidi.send({
+            method: 'input.releaseActions',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async setFiles(params) {
+        const response = await this.bidi.send({
+            method: 'input.setFiles',
+            params: params,
+        });
+        if (response['type'] === 'error') {
+            throw new Error(`${response['error']}: ${response['message']}`);
+        }
+    }
+    async onFileDialogOpened(callback) {
+        await this.bidi.subscribe('input.fileDialogOpened');
+        this.bidi.on('input.fileDialogOpened', (params) => {
+            callback(params);
+        });
+    }
+    /** @deprecated Use {@link performActions} instead — will be removed in a future major version. */
+    async perform(browsingContextId, actions) {
+        await this.performActions({ context: browsingContextId, actions });
+    }
+    /** @deprecated Use {@link releaseActions} instead — will be removed in a future major version. */
+    async release(browsingContextId) {
+        await this.releaseActions({ context: browsingContextId });
+    }
+}
+exports.Input = Input;

package/bidi/generated/log.d.ts

@@ -0,0 +1,39 @@
+import type { JsUint } from './common.js';
+import type { ScriptRemoteValue, ScriptSource, ScriptStackTrace } from './script.js';
+export type LogEvent = LogEntryAdded;
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export type LogEntry = LogGenericLogEntry | LogConsoleLogEntry | LogJavascriptLogEntry;
+export interface LogBaseLogEntry {
+    level: LogLevel;
+    source: ScriptSource;
+    text: string | null;
+    timestamp: JsUint;
+    stackTrace?: ScriptStackTrace;
+}
+export type LogGenericLogEntry = LogBaseLogEntry & {
+    type: string;
+};
+export type LogConsoleLogEntry = LogBaseLogEntry & {
+    type: "console";
+    method: string;
+    args: ScriptRemoteValue[];
+};
+export type LogJavascriptLogEntry = LogBaseLogEntry & {
+    type: "javascript";
+};
+export interface LogEntryAdded {
+    method: "log.entryAdded";
+    params: LogEntry;
+}
+/** @deprecated Use {@link Log.create} instead — will be removed in a future major version. */
+export declare function getLogInspectorInstance(driver: unknown): Promise<Log>;
+export declare class Log {
+    private readonly bidi;
+    private constructor();
+    static create(driver: unknown): Promise<Log>;
+    onEntryAdded(callback: (params: LogEntry) => void): Promise<void>;
+    onConsoleEntry(callback: (params: LogEntry) => void): Promise<void>;
+    onJavascriptLog(callback: (params: LogEntry) => void): Promise<void>;
+    onJavascriptException(callback: (params: LogEntry) => void): Promise<void>;
+    onLog(callback: (params: LogEntry) => void): Promise<void>;
+}

package/bidi/generated/log.js

@@ -0,0 +1,67 @@
+"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.Log = exports.getLogInspectorInstance = void 0;
+// --- 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) {
+        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 Log(bidi);
+    }
+    async onEntryAdded(callback) {
+        await this.bidi.subscribe('log.entryAdded');
+        this.bidi.on('log.entryAdded', (params) => {
+            callback(params);
+        });
+    }
+    async onConsoleEntry(callback) {
+        await this.onEntryAdded((entry) => {
+            if (entry.type === 'console')
+                callback(entry);
+        });
+    }
+    async onJavascriptLog(callback) {
+        await this.onEntryAdded((entry) => {
+            if (entry.type === 'javascript')
+                callback(entry);
+        });
+    }
+    async onJavascriptException(callback) {
+        await this.onEntryAdded((entry) => {
+            if (entry.type === 'javascript' && entry.level === 'error')
+                callback(entry);
+        });
+    }
+    async onLog(callback) {
+        await this.onEntryAdded(callback);
+    }
+}
+exports.Log = Log;