selenium-webdriver 4.46.0 → 4.47.0

data/lib/selenium/webdriver/{common/driver_extensions/has_bidi.rb → bidi/error.rb}

@@ -17,20 +17,28 @@
 # specific language governing permissions and limitations
 # under the License.
 
+require 'selenium/webdriver/common/error'
+require 'selenium/webdriver/bidi/protocol/error_code'
+
 module Selenium
   module WebDriver
-    module DriverExtensions
-      module HasBiDi
-        #
-        # Retrieves WebDriver BiDi connection.
-        #
-        # @return [BiDi]
-        #
+    module Error
+      # Register each BiDi-only code as a WebDriverError subclass; shared codes keep their classic class.
+      BiDi::Protocol::ErrorCode::CLASS_NAMES.each_value do |name|
+        const_set(name, Class.new(WebDriverError)) unless const_defined?(name, false)
+      end
+    end
 
-        def bidi
-          @bridge.bidi
+    class BiDi
+      module Protocol
+        module ErrorCode
+          # The exception class for a wire error code, or WebDriverError for an unknown one.
+          def self.for(code)
+            name = code && CLASS_NAMES[code]
+            name ? Error.const_get(name) : Error::WebDriverError
+          end
         end
-      end # HasBiDi
-    end # DriverExtensions
-  end # WebDriver
-end # Selenium
+      end
+    end
+  end
+end

data/lib/selenium/webdriver/bidi/protocol/bluetooth.rb

@@ -17,8 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
-# This file is automatically generated. DO NOT EDIT!
-# Regenerate with: bazel run //rb/lib/selenium/webdriver:bidi-generate
+# DO NOT EDIT! This file is generated by rb/lib/selenium/webdriver/bidi/support/bidi_generate.rb.
+# Regenerate with: `bazel run //rb/lib/selenium/webdriver:bidi-generate`
 
 module Selenium
   module WebDriver
@@ -80,6 +80,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothbluetoothmanufacturerdata
           BluetoothManufacturerData = Serialization::Record.define(
             key: {wire_key: 'key', primitive: 'integer'},
             data: {wire_key: 'data', primitive: 'string'}
@@ -87,6 +88,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothcharacteristicproperties
           CharacteristicProperties = Serialization::Record.define(
             broadcast: {wire_key: 'broadcast', required: false, primitive: 'boolean'},
             read: {wire_key: 'read', required: false, primitive: 'boolean'},
@@ -100,13 +102,15 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothrequestdeviceinfo
           RequestDeviceInfo = Serialization::Record.define(
-            id: 'id',
+            id: {wire_key: 'id', primitive: 'string'},
             name: {wire_key: 'name', nullable: true, primitive: 'string'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothscanrecord
           ScanRecord = Serialization::Record.define(
             name: {wire_key: 'name', required: false, primitive: 'string'},
             uuids: {wire_key: 'uuids', required: false, list: true},
@@ -121,20 +125,22 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothhandlerequestdevicepromptparameters
           class HandleRequestDevicePromptParameters < Serialization::Union
             discriminator 'accept'
             variants(
               true => 'Bluetooth::HandleRequestDevicePromptParameters::AcceptParameters',
               false => 'Bluetooth::HandleRequestDevicePromptParameters::CancelParameters'
             )
+            object_only
 
             # @api private
             # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
             AcceptParameters = Serialization::Record.define(
               accept: {fixed: true},
               context: {wire_key: 'context', primitive: 'string'},
-              prompt: 'prompt',
-              device: 'device'
+              prompt: {wire_key: 'prompt', primitive: 'string'},
+              device: {wire_key: 'device', primitive: 'string'}
             )
 
             # @api private
@@ -142,12 +148,16 @@ module Selenium
             CancelParameters = Serialization::Record.define(
               accept: {fixed: false},
               context: {wire_key: 'context', primitive: 'string'},
-              prompt: 'prompt'
+              prompt: {wire_key: 'prompt', primitive: 'string'}
             )
+
+            def self.true(**) = Bluetooth::HandleRequestDevicePromptParameters::AcceptParameters.new(**)
+            def self.false(**) = Bluetooth::HandleRequestDevicePromptParameters::CancelParameters.new(**)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadapterparameters
           SimulateAdapterParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             le_supported: {wire_key: 'leSupported', required: false, primitive: 'boolean'},
@@ -156,12 +166,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothdisablesimulationparameters
           DisableSimulationParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatepreconnectedperipheralparameters
           SimulatePreconnectedPeripheralParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -172,6 +184,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadvertisementparameters
           SimulateAdvertisementParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             scan_entry: {wire_key: 'scanEntry', ref: 'Bluetooth::SimulateAdvertisementScanEntryParameters'}
@@ -179,6 +192,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadvertisementscanentryparameters
           SimulateAdvertisementScanEntryParameters = Serialization::Record.define(
             device_address: {wire_key: 'deviceAddress', primitive: 'string'},
             rssi: {wire_key: 'rssi', primitive: 'number'},
@@ -187,6 +201,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulategattconnectionresponseparameters
           SimulateGattConnectionResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -195,6 +210,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulategattdisconnectionparameters
           SimulateGattDisconnectionParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'}
@@ -202,20 +218,22 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateserviceparameters
           SimulateServiceParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            uuid: 'uuid',
+            uuid: {wire_key: 'uuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::SIMULATE_SERVICE_PARAMETERS_TYPE'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatecharacteristicparameters
           SimulateCharacteristicParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
             characteristic_properties: {
               wire_key: 'characteristicProperties',
               required: false,
@@ -226,11 +244,12 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatecharacteristicresponseparameters
           SimulateCharacteristicResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::SIMULATE_CHARACTERISTIC_RESPONSE_PARAMETERS_TYPE'},
             code: {wire_key: 'code', primitive: 'integer'},
             data: {wire_key: 'data', required: false, list: true}
@@ -238,23 +257,25 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatedescriptorparameters
           SimulateDescriptorParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
-            descriptor_uuid: 'descriptorUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
+            descriptor_uuid: {wire_key: 'descriptorUuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::SIMULATE_DESCRIPTOR_PARAMETERS_TYPE'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatedescriptorresponseparameters
           SimulateDescriptorResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
-            descriptor_uuid: 'descriptorUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
+            descriptor_uuid: {wire_key: 'descriptorUuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::SIMULATE_DESCRIPTOR_RESPONSE_PARAMETERS_TYPE'},
             code: {wire_key: 'code', primitive: 'integer'},
             data: {wire_key: 'data', required: false, list: true}
@@ -262,14 +283,16 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothrequestdevicepromptupdatedparameters
           RequestDevicePromptUpdatedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
-            prompt: 'prompt',
+            prompt: {wire_key: 'prompt', primitive: 'string'},
             devices: {wire_key: 'devices', ref: 'Bluetooth::RequestDeviceInfo', list: true}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothgattconnectionattemptedparameters
           GattConnectionAttemptedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'}
@@ -277,23 +300,25 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothcharacteristiceventgeneratedparameters
           CharacteristicEventGeneratedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::CHARACTERISTIC_EVENT_GENERATED_PARAMETERS_TYPE'},
             data: {wire_key: 'data', required: false, list: true}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothdescriptoreventgeneratedparameters
           DescriptorEventGeneratedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
-            service_uuid: 'serviceUuid',
-            characteristic_uuid: 'characteristicUuid',
-            descriptor_uuid: 'descriptorUuid',
+            service_uuid: {wire_key: 'serviceUuid', primitive: 'string'},
+            characteristic_uuid: {wire_key: 'characteristicUuid', primitive: 'string'},
+            descriptor_uuid: {wire_key: 'descriptorUuid', primitive: 'string'},
             type: {wire_key: 'type', enum: 'Bluetooth::DESCRIPTOR_EVENT_GENERATED_PARAMETERS_TYPE'},
             data: {wire_key: 'data', required: false, list: true}
           )
@@ -303,6 +328,11 @@ module Selenium
             'bluetooth.gattConnectionAttempted' => Bluetooth::GattConnectionAttemptedParameters
           }.freeze
 
+          def bluetooth_manufacturer_data(**) = BluetoothManufacturerData.new(**)
+          def characteristic_properties(**) = CharacteristicProperties.new(**)
+          def scan_record(**) = ScanRecord.new(**)
+          def simulate_advertisement_scan_entry_parameters(**) = SimulateAdvertisementScanEntryParameters.new(**)
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           def handle_request_device_prompt(context:, prompt:, accept:, device: Serialization::UNSET)

data/lib/selenium/webdriver/bidi/protocol/browser.rb

@@ -17,8 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
-# This file is automatically generated. DO NOT EDIT!
-# Regenerate with: bazel run //rb/lib/selenium/webdriver:bidi-generate
+# DO NOT EDIT! This file is generated by rb/lib/selenium/webdriver/bidi/support/bidi_generate.rb.
+# Regenerate with: `bazel run //rb/lib/selenium/webdriver:bidi-generate`
 
 module Selenium
   module WebDriver
@@ -26,6 +26,7 @@ module Selenium
       module Protocol
         # @api private
         # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        # @see https://w3c.github.io/webdriver-bidi/#module-browser
         class Browser < Domain
           CLIENT_WINDOW_INFO_STATE = {
             fullscreen: 'fullscreen',
@@ -42,22 +43,25 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-browser-ClientWindowInfo
           ClientWindowInfo = Serialization::Record.define(
             active: {wire_key: 'active', primitive: 'boolean'},
-            client_window: 'clientWindow',
-            height: 'height',
+            client_window: {wire_key: 'clientWindow', primitive: 'string'},
+            height: {wire_key: 'height', primitive: 'integer'},
             state: {wire_key: 'state', enum: 'Browser::CLIENT_WINDOW_INFO_STATE'},
-            width: 'width',
-            x: 'x',
-            y: 'y'
+            width: {wire_key: 'width', primitive: 'integer'},
+            x: {wire_key: 'x', primitive: 'integer'},
+            y: {wire_key: 'y', primitive: 'integer'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          UserContextInfo = Serialization::Record.define(user_context: 'userContext')
+          # @see https://w3c.github.io/webdriver-bidi/#type-browser-UserContextInfo
+          UserContextInfo = Serialization::Record.define(user_context: {wire_key: 'userContext', primitive: 'string'})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsercreateusercontextparameters
           CreateUserContextParameters = Serialization::Record.define(
             accept_insecure_certs: {wire_key: 'acceptInsecureCerts', required: false, primitive: 'boolean'},
             proxy: {wire_key: 'proxy', required: false, ref: 'Session::ProxyConfiguration'},
@@ -70,33 +74,40 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsergetclientwindowsresult
           GetClientWindowsResult = Serialization::Record.define(
             client_windows: {wire_key: 'clientWindows', ref: 'Browser::ClientWindowInfo', list: true}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsergetusercontextsresult
           GetUserContextsResult = Serialization::Record.define(
             user_contexts: {wire_key: 'userContexts', ref: 'Browser::UserContextInfo', list: true}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          RemoveUserContextParameters = Serialization::Record.define(user_context: 'userContext')
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browserremoveusercontextparameters
+          RemoveUserContextParameters = Serialization::Record.define(
+            user_context: {wire_key: 'userContext', primitive: 'string'}
+          )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsersetclientwindowstateparameters
           class SetClientWindowStateParameters < Serialization::Union
             discriminator 'state', {normal: 'normal'}
             variants(
               normal: 'Browser::SetClientWindowStateParameters::ClientWindowRectState'
             )
             fallback 'Browser::SetClientWindowStateParameters::ClientWindowNamedState'
+            object_only
 
             # @api private
             # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
             ClientWindowNamedState = Serialization::Record.define(
-              client_window: 'clientWindow',
+              client_window: {wire_key: 'clientWindow', primitive: 'string'},
               state: {wire_key: 'state', enum: 'Browser::CLIENT_WINDOW_NAMED_STATE_STATE'}
             )
 
@@ -104,16 +115,19 @@ module Selenium
             # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
             ClientWindowRectState = Serialization::Record.define(
               state: {fixed: 'normal'},
-              client_window: 'clientWindow',
-              width: {wire_key: 'width', required: false},
-              height: {wire_key: 'height', required: false},
-              x: {wire_key: 'x', required: false},
-              y: {wire_key: 'y', required: false}
+              client_window: {wire_key: 'clientWindow', primitive: 'string'},
+              width: {wire_key: 'width', required: false, primitive: 'integer'},
+              height: {wire_key: 'height', required: false, primitive: 'integer'},
+              x: {wire_key: 'x', required: false, primitive: 'integer'},
+              y: {wire_key: 'y', required: false, primitive: 'integer'}
             )
+
+            def self.normal(**) = Browser::SetClientWindowStateParameters::ClientWindowRectState.new(**)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsersetdownloadbehaviorparameters
           SetDownloadBehaviorParameters = Serialization::Record.define(
             download_behavior: {wire_key: 'downloadBehavior', nullable: true, ref: 'Browser::DownloadBehavior'},
             user_contexts: {wire_key: 'userContexts', required: false, list: true}
@@ -121,12 +135,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browserdownloadbehavior
           class DownloadBehavior < Serialization::Union
             discriminator 'type', {allowed: 'allowed', denied: 'denied'}
             variants(
               allowed: 'Browser::DownloadBehavior::Allowed',
               denied: 'Browser::DownloadBehavior::Denied'
             )
+            object_only
 
             # @api private
             # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
@@ -138,16 +154,23 @@ module Selenium
             # @api private
             # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
             Denied = Serialization::Record.define(type: {fixed: 'denied'})
+
+            def self.allowed(**) = Browser::DownloadBehavior::Allowed.new(**)
+            def self.denied(**) = Browser::DownloadBehavior::Denied.new(**)
           end
 
+          def download_behavior = DownloadBehavior
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-close
           def close
             execute(cmd: 'browser.close')
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-createUserContext
           def create_user_context(
             accept_insecure_certs: Serialization::UNSET,
             proxy: Serialization::UNSET,
@@ -163,18 +186,21 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-getClientWindows
           def get_client_windows
             execute(cmd: 'browser.getClientWindows', result: Browser::GetClientWindowsResult)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-getUserContexts
           def get_user_contexts
             execute(cmd: 'browser.getUserContexts', result: Browser::GetUserContextsResult)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-removeUserContext
           def remove_user_context(user_context:)
             params = RemoveUserContextParameters.new(user_context: user_context)
             execute(cmd: 'browser.removeUserContext', params: params)
@@ -182,6 +208,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-setClientWindowState
           def set_client_window_state(
             client_window:,
             state:,
@@ -208,6 +235,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-browser-setDownloadBehavior
           def set_download_behavior(download_behavior:, user_contexts: Serialization::UNSET)
             params = SetDownloadBehaviorParameters.new(
               download_behavior: download_behavior,