selenium-webdriver 4.49.0 → 4.50.0

package/CHANGES.md

@@ -1,3 +1,19 @@
+## 4.50.0
+
+- Support CDP versions: v152, v153, v154
+- [build] Automated Dependency Update (#18032)
+- [build] generate webref_cddl.bzl from the BiDi spec's external specifications list (#18055)
+- [build] replace the BiDi KNOWN_INCOMPLETE allowlist with spec-shaped CDDL overlays (#18057)
+- [build] Automated Dependency Update (#18061)
+- [build] generate the BiDi schema vendor section from Mozilla's Firefox CDDL (#18060)
+- remove deprecated Firefox profile extension and cert methods (#18066)
+- [build] add support for Mozilla's Commands fragment in the BiDi schema (#18071)
+- Align BiDi Generator with the low-level contract (#17973)
+- [build] Automated Browser Version Update (major) with CDP (#18067)
+- [build] Automated CDDL Spec Update (#18075)
+- [build] Automated Dependency Update (#18082)
+- Run tests on Grid, MacOS and Windows (#18081)
+
 ## 4.49.0
 
 - Support CDP versions: v151, v152, v153

package/bidi/generated/bluetooth.d.ts

@@ -1,3 +1,4 @@
+import { Domain, type EventDescriptor } from '../domain.js';
 export type BluetoothBluetoothUuid = string;
 export interface BluetoothBluetoothManufacturerData {
     key: number;
@@ -21,26 +22,15 @@ export interface BluetoothRequestDeviceInfo {
 export type BluetoothRequestDevicePrompt = string;
 export interface BluetoothScanRecord {
     name?: string;
-    uuids?: BluetoothBluetoothUuid[];
-    appearance?: Number;
-    manufacturerData?: BluetoothBluetoothManufacturerData[];
+    uuids?: Array<BluetoothBluetoothUuid>;
+    appearance?: number;
+    manufacturerData?: Array<BluetoothBluetoothManufacturerData>;
 }
-export type BluetoothCommand = BluetoothHandleRequestDevicePrompt | BluetoothSimulateAdapter | BluetoothDisableSimulation | BluetoothSimulatePreconnectedPeripheral | BluetoothSimulateAdvertisement | BluetoothSimulateGattConnectionResponse | BluetoothSimulateGattDisconnection | BluetoothSimulateService | BluetoothSimulateCharacteristic | BluetoothSimulateCharacteristicResponse | BluetoothSimulateDescriptor | BluetoothSimulateDescriptorResponse;
 export interface BluetoothHandleRequestDevicePrompt {
     method: "bluetooth.handleRequestDevicePrompt";
     params: BluetoothHandleRequestDevicePromptParameters;
 }
-export type BluetoothHandleRequestDevicePromptParameters = (BluetoothHandleRequestDevicePromptAcceptParameters | BluetoothHandleRequestDevicePromptCancelParameters) & {
-    context: string;
-    prompt: BluetoothRequestDevicePrompt;
-};
-export interface BluetoothHandleRequestDevicePromptAcceptParameters {
-    accept: true;
-    device: BluetoothRequestDevice;
-}
-export interface BluetoothHandleRequestDevicePromptCancelParameters {
-    accept: false;
-}
+export type BluetoothHandleRequestDevicePromptParameters = BluetoothHandleRequestDevicePromptParameters_AcceptParameters | BluetoothHandleRequestDevicePromptParameters_CancelParameters;
 export interface BluetoothSimulateAdapter {
     method: "bluetooth.simulateAdapter";
     params: BluetoothSimulateAdapterParameters;
@@ -48,7 +38,7 @@ export interface BluetoothSimulateAdapter {
 export interface BluetoothSimulateAdapterParameters {
     context: string;
     leSupported?: boolean;
-    state: "absent" | "powered-off" | "powered-on";
+    state: BluetoothSimulateAdapterParametersState;
 }
 export interface BluetoothDisableSimulation {
     method: "bluetooth.disableSimulation";
@@ -65,8 +55,8 @@ export interface BluetoothSimulatePreconnectedPeripheralParameters {
     context: string;
     address: string;
     name: string;
-    manufacturerData: BluetoothBluetoothManufacturerData[];
-    knownServiceUuids: BluetoothBluetoothUuid[];
+    manufacturerData: Array<BluetoothBluetoothManufacturerData>;
+    knownServiceUuids: Array<BluetoothBluetoothUuid>;
 }
 export interface BluetoothSimulateAdvertisement {
     method: "bluetooth.simulateAdvertisement";
@@ -78,7 +68,7 @@ export interface BluetoothSimulateAdvertisementParameters {
 }
 export interface BluetoothSimulateAdvertisementScanEntryParameters {
     deviceAddress: string;
-    rssi: Number;
+    rssi: number;
     scanRecord: BluetoothScanRecord;
 }
 export interface BluetoothSimulateGattConnectionResponse {
@@ -106,7 +96,7 @@ export interface BluetoothSimulateServiceParameters {
     context: string;
     address: string;
     uuid: BluetoothBluetoothUuid;
-    type: "add" | "remove";
+    type: BluetoothSimulateServiceParametersType;
 }
 export interface BluetoothSimulateCharacteristic {
     method: "bluetooth.simulateCharacteristic";
@@ -118,7 +108,7 @@ export interface BluetoothSimulateCharacteristicParameters {
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
     characteristicProperties?: BluetoothCharacteristicProperties;
-    type: "add" | "remove";
+    type: BluetoothSimulateCharacteristicParametersType;
 }
 export interface BluetoothSimulateCharacteristicResponse {
     method: "bluetooth.simulateCharacteristicResponse";
@@ -129,9 +119,9 @@ export interface BluetoothSimulateCharacteristicResponseParameters {
     address: string;
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
-    type: "read" | "write" | "subscribe-to-notifications" | "unsubscribe-from-notifications";
+    type: BluetoothSimulateCharacteristicResponseParametersType;
     code: number;
-    data?: number[];
+    data?: Array<number>;
 }
 export interface BluetoothSimulateDescriptor {
     method: "bluetooth.simulateDescriptor";
@@ -143,7 +133,7 @@ export interface BluetoothSimulateDescriptorParameters {
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
     descriptorUuid: BluetoothBluetoothUuid;
-    type: "add" | "remove";
+    type: BluetoothSimulateDescriptorParametersType;
 }
 export interface BluetoothSimulateDescriptorResponse {
     method: "bluetooth.simulateDescriptorResponse";
@@ -155,11 +145,10 @@ export interface BluetoothSimulateDescriptorResponseParameters {
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
     descriptorUuid: BluetoothBluetoothUuid;
-    type: "read" | "write";
+    type: BluetoothSimulateDescriptorResponseParametersType;
     code: number;
-    data?: number[];
+    data?: Array<number>;
 }
-export type BluetoothEvent = BluetoothRequestDevicePromptUpdated | BluetoothGattConnectionAttempted;
 export interface BluetoothRequestDevicePromptUpdated {
     method: "bluetooth.requestDevicePromptUpdated";
     params: BluetoothRequestDevicePromptUpdatedParameters;
@@ -167,7 +156,7 @@ export interface BluetoothRequestDevicePromptUpdated {
 export interface BluetoothRequestDevicePromptUpdatedParameters {
     context: string;
     prompt: BluetoothRequestDevicePrompt;
-    devices: BluetoothRequestDeviceInfo[];
+    devices: Array<BluetoothRequestDeviceInfo>;
 }
 export interface BluetoothGattConnectionAttempted {
     method: "bluetooth.gattConnectionAttempted";
@@ -186,8 +175,8 @@ export interface BluetoothCharacteristicEventGeneratedParameters {
     address: string;
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
-    type: "read" | "write-with-response" | "write-without-response" | "subscribe-to-notifications" | "unsubscribe-from-notifications";
-    data?: number[];
+    type: BluetoothCharacteristicEventGeneratedParametersType;
+    data?: Array<number>;
 }
 export interface BluetoothDescriptorEventGenerated {
     method: "bluetooth.descriptorEventGenerated";
@@ -199,25 +188,198 @@ export interface BluetoothDescriptorEventGeneratedParameters {
     serviceUuid: BluetoothBluetoothUuid;
     characteristicUuid: BluetoothBluetoothUuid;
     descriptorUuid: BluetoothBluetoothUuid;
-    type: "read" | "write";
-    data?: number[];
+    type: BluetoothDescriptorEventGeneratedParametersType;
+    data?: Array<number>;
+}
+export type BluetoothSimulateAdapterParametersState = "absent" | "powered-off" | "powered-on";
+export type BluetoothSimulateServiceParametersType = "add" | "remove";
+export type BluetoothSimulateCharacteristicParametersType = "add" | "remove";
+export type BluetoothSimulateCharacteristicResponseParametersType = "read" | "write" | "subscribe-to-notifications" | "unsubscribe-from-notifications";
+export type BluetoothSimulateDescriptorParametersType = "add" | "remove";
+export type BluetoothSimulateDescriptorResponseParametersType = "read" | "write";
+export type BluetoothCharacteristicEventGeneratedParametersType = "read" | "write-with-response" | "write-without-response" | "subscribe-to-notifications" | "unsubscribe-from-notifications";
+export type BluetoothDescriptorEventGeneratedParametersType = "read" | "write";
+export interface BluetoothHandleRequestDevicePromptParameters_AcceptParameters {
+    context: string;
+    prompt: BluetoothRequestDevicePrompt;
+    accept: true;
+    device: BluetoothRequestDevice;
+}
+export interface BluetoothHandleRequestDevicePromptParameters_CancelParameters {
+    context: string;
+    prompt: BluetoothRequestDevicePrompt;
+    accept: false;
 }
-export declare class Bluetooth {
-    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 Bluetooth extends Domain {
+    /** @see https://w3c.github.io/webdriver-bidi/#event-bluetooth-requestDevicePromptUpdated */
+    static readonly REQUEST_DEVICE_PROMPT_UPDATED: EventDescriptor<BluetoothRequestDevicePromptUpdatedParameters>;
+    /** @see https://w3c.github.io/webdriver-bidi/#event-bluetooth-gattConnectionAttempted */
+    static readonly GATT_CONNECTION_ATTEMPTED: EventDescriptor<BluetoothGattConnectionAttemptedParameters>;
+    /** @see https://w3c.github.io/webdriver-bidi/#event-bluetooth-characteristicEventGenerated */
+    static readonly CHARACTERISTIC_EVENT_GENERATED: EventDescriptor<BluetoothCharacteristicEventGeneratedParameters>;
+    /** @see https://w3c.github.io/webdriver-bidi/#event-bluetooth-descriptorEventGenerated */
+    static readonly DESCRIPTOR_EVENT_GENERATED: EventDescriptor<BluetoothDescriptorEventGeneratedParameters>;
+    static readonly SimulateAdapterParametersState: Readonly<{
+        readonly ABSENT: "absent";
+        readonly POWERED_OFF: "powered-off";
+        readonly POWERED_ON: "powered-on";
+    }>;
+    static readonly SimulateServiceParametersType: Readonly<{
+        readonly ADD: "add";
+        readonly REMOVE: "remove";
+    }>;
+    static readonly SimulateCharacteristicParametersType: Readonly<{
+        readonly ADD: "add";
+        readonly REMOVE: "remove";
+    }>;
+    static readonly SimulateCharacteristicResponseParametersType: Readonly<{
+        readonly READ: "read";
+        readonly WRITE: "write";
+        readonly SUBSCRIBE_TO_NOTIFICATIONS: "subscribe-to-notifications";
+        readonly UNSUBSCRIBE_FROM_NOTIFICATIONS: "unsubscribe-from-notifications";
+    }>;
+    static readonly SimulateDescriptorParametersType: Readonly<{
+        readonly ADD: "add";
+        readonly REMOVE: "remove";
+    }>;
+    static readonly SimulateDescriptorResponseParametersType: Readonly<{
+        readonly READ: "read";
+        readonly WRITE: "write";
+    }>;
+    static readonly CharacteristicEventGeneratedParametersType: Readonly<{
+        readonly READ: "read";
+        readonly WRITE_WITH_RESPONSE: "write-with-response";
+        readonly WRITE_WITHOUT_RESPONSE: "write-without-response";
+        readonly SUBSCRIBE_TO_NOTIFICATIONS: "subscribe-to-notifications";
+        readonly UNSUBSCRIBE_FROM_NOTIFICATIONS: "unsubscribe-from-notifications";
+    }>;
+    static readonly DescriptorEventGeneratedParametersType: Readonly<{
+        readonly READ: "read";
+        readonly WRITE: "write";
+    }>;
     static create(driver: unknown): Promise<Bluetooth>;
+    /**
+     * @param {BluetoothHandleRequestDevicePromptParameters} params
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-handleRequestDevicePrompt
+     */
     handleRequestDevicePrompt(params: BluetoothHandleRequestDevicePromptParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateAdapterParameters} params
+     * @param {string} params.context
+     * @param {boolean} [params.leSupported]
+     * @param {BluetoothSimulateAdapterParametersState} params.state
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateAdapter
+     */
     simulateAdapter(params: BluetoothSimulateAdapterParameters): Promise<void>;
+    /**
+     * @param {BluetoothDisableSimulationParameters} params
+     * @param {string} params.context
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-disableSimulation
+     */
     disableSimulation(params: BluetoothDisableSimulationParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulatePreconnectedPeripheralParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {string} params.name
+     * @param {Array<BluetoothBluetoothManufacturerData>} params.manufacturerData
+     * @param {Array<BluetoothBluetoothUuid>} params.knownServiceUuids
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulatePreconnectedPeripheral
+     */
     simulatePreconnectedPeripheral(params: BluetoothSimulatePreconnectedPeripheralParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateAdvertisementParameters} params
+     * @param {string} params.context
+     * @param {BluetoothSimulateAdvertisementScanEntryParameters} params.scanEntry
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateAdvertisement
+     */
     simulateAdvertisement(params: BluetoothSimulateAdvertisementParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateGattConnectionResponseParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {number} params.code
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateGattConnectionResponse
+     */
     simulateGattConnectionResponse(params: BluetoothSimulateGattConnectionResponseParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateGattDisconnectionParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateGattDisconnection
+     */
     simulateGattDisconnection(params: BluetoothSimulateGattDisconnectionParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateServiceParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {BluetoothBluetoothUuid} params.uuid
+     * @param {BluetoothSimulateServiceParametersType} params.type
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateService
+     */
     simulateService(params: BluetoothSimulateServiceParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateCharacteristicParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {BluetoothBluetoothUuid} params.serviceUuid
+     * @param {BluetoothBluetoothUuid} params.characteristicUuid
+     * @param {BluetoothCharacteristicProperties} [params.characteristicProperties]
+     * @param {BluetoothSimulateCharacteristicParametersType} params.type
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateCharacteristic
+     */
     simulateCharacteristic(params: BluetoothSimulateCharacteristicParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateCharacteristicResponseParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {BluetoothBluetoothUuid} params.serviceUuid
+     * @param {BluetoothBluetoothUuid} params.characteristicUuid
+     * @param {BluetoothSimulateCharacteristicResponseParametersType} params.type
+     * @param {number} params.code
+     * @param {Array<number>} [params.data]
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateCharacteristicResponse
+     */
     simulateCharacteristicResponse(params: BluetoothSimulateCharacteristicResponseParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateDescriptorParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {BluetoothBluetoothUuid} params.serviceUuid
+     * @param {BluetoothBluetoothUuid} params.characteristicUuid
+     * @param {BluetoothBluetoothUuid} params.descriptorUuid
+     * @param {BluetoothSimulateDescriptorParametersType} params.type
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateDescriptor
+     */
     simulateDescriptor(params: BluetoothSimulateDescriptorParameters): Promise<void>;
+    /**
+     * @param {BluetoothSimulateDescriptorResponseParameters} params
+     * @param {string} params.context
+     * @param {string} params.address
+     * @param {BluetoothBluetoothUuid} params.serviceUuid
+     * @param {BluetoothBluetoothUuid} params.characteristicUuid
+     * @param {BluetoothBluetoothUuid} params.descriptorUuid
+     * @param {BluetoothSimulateDescriptorResponseParametersType} params.type
+     * @param {number} params.code
+     * @param {Array<number>} [params.data]
+     * @returns {Promise<void>}
+     * @see https://w3c.github.io/webdriver-bidi/#command-bluetooth-simulateDescriptorResponse
+     */
     simulateDescriptorResponse(params: BluetoothSimulateDescriptorResponseParameters): Promise<void>;
-    onRequestDevicePromptUpdated(callback: (params: BluetoothRequestDevicePromptUpdatedParameters) => void): Promise<void>;
-    onGattConnectionAttempted(callback: (params: BluetoothGattConnectionAttemptedParameters) => void): Promise<void>;
 }