selenium-webdriver 4.46.0 → 4.47.0

data/lib/selenium/webdriver/bidi/protocol/session.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,7 +26,9 @@ module Selenium
       module Protocol
         # @api private
         # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        # @see https://w3c.github.io/webdriver-bidi/#module-session
         class Session < Domain
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-UserPromptHandlerType
           USER_PROMPT_HANDLER_TYPE = {
             accept: 'accept',
             dismiss: 'dismiss',
@@ -35,6 +37,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-CapabilitiesRequest
           CapabilitiesRequest = Serialization::Record.define(
             always_match: {wire_key: 'alwaysMatch', required: false, ref: 'Session::CapabilityRequest'},
             first_match: {wire_key: 'firstMatch', required: false, ref: 'Session::CapabilityRequest', list: true}
@@ -42,6 +45,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-CapabilityRequest
           CapabilityRequest = Serialization::Record.define(
             accept_insecure_certs: {wire_key: 'acceptInsecureCerts', required: false, primitive: 'boolean'},
             browser_name: {wire_key: 'browserName', required: false, primitive: 'string'},
@@ -58,6 +62,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-ProxyConfiguration
           class ProxyConfiguration < Serialization::Union
             discriminator 'proxyType', {
               autodetect: 'autodetect',
@@ -73,10 +78,18 @@ module Selenium
               pac: 'Session::PacProxyConfiguration',
               system: 'Session::SystemProxyConfiguration'
             )
+            object_only
+
+            def self.autodetect(**) = Session::AutodetectProxyConfiguration.new(**)
+            def self.direct(**) = Session::DirectProxyConfiguration.new(**)
+            def self.manual(**) = Session::ManualProxyConfiguration.new(**)
+            def self.pac(**) = Session::PacProxyConfiguration.new(**)
+            def self.system(**) = Session::SystemProxyConfiguration.new(**)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionautodetectproxyconfiguration
           AutodetectProxyConfiguration = Serialization::Record.define(
             proxy_type: {wire_key: 'proxyType', fixed: 'autodetect'},
             extensible: true
@@ -84,6 +97,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessiondirectproxyconfiguration
           DirectProxyConfiguration = Serialization::Record.define(
             proxy_type: {wire_key: 'proxyType', fixed: 'direct'},
             extensible: true
@@ -91,6 +105,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionmanualproxyconfiguration
           ManualProxyConfiguration = Serialization::Record.define(
             proxy_type: {wire_key: 'proxyType', fixed: 'manual'},
             http_proxy: {wire_key: 'httpProxy', required: false, primitive: 'string'},
@@ -103,6 +118,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionsocksproxyconfiguration
           SocksProxyConfiguration = Serialization::Record.define(
             socks_proxy: {wire_key: 'socksProxy', primitive: 'string'},
             socks_version: {wire_key: 'socksVersion', primitive: 'integer'}
@@ -110,6 +126,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionpacproxyconfiguration
           PacProxyConfiguration = Serialization::Record.define(
             proxy_type: {wire_key: 'proxyType', fixed: 'pac'},
             proxy_autoconfig_url: {wire_key: 'proxyAutoconfigUrl', primitive: 'string'},
@@ -118,6 +135,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionsystemproxyconfiguration
           SystemProxyConfiguration = Serialization::Record.define(
             proxy_type: {wire_key: 'proxyType', fixed: 'system'},
             extensible: true
@@ -125,6 +143,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-UserPromptHandler
           UserPromptHandler = Serialization::Record.define(
             alert: {wire_key: 'alert', required: false, enum: 'Session::USER_PROMPT_HANDLER_TYPE'},
             before_unload: {wire_key: 'beforeUnload', required: false, enum: 'Session::USER_PROMPT_HANDLER_TYPE'},
@@ -136,6 +155,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionsubscribeparameters
           SubscribeParameters = Serialization::Record.define(
             events: {wire_key: 'events', list: true},
             contexts: {wire_key: 'contexts', required: false, list: true},
@@ -144,14 +164,17 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-UnsubscribeByIDRequest
           UnsubscribeByIDRequest = Serialization::Record.define(subscriptions: {wire_key: 'subscriptions', list: true})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-session-UnsubscribeByAttributesRequest
           UnsubscribeByAttributesRequest = Serialization::Record.define(events: {wire_key: 'events', list: true})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionstatusresult
           StatusResult = Serialization::Record.define(
             ready: {wire_key: 'ready', primitive: 'boolean'},
             message: {wire_key: 'message', primitive: 'string'}
@@ -159,12 +182,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionnewparameters
           NewParameters = Serialization::Record.define(
             capabilities: {wire_key: 'capabilities', ref: 'Session::CapabilitiesRequest'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionnewresult
           NewResult = Serialization::Record.define(
             session_id: {wire_key: 'sessionId', primitive: 'string'},
             capabilities: {wire_key: 'capabilities', ref: 'Session::NewResult::Capabilities'}
@@ -191,25 +216,42 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          SubscribeResult = Serialization::Record.define(subscription: 'subscription')
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionsubscriberesult
+          SubscribeResult = Serialization::Record.define(subscription: {wire_key: 'subscription', primitive: 'string'})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-sessionunsubscribeparameters
           class UnsubscribeParameters < Serialization::Union
             presence(
               'Session::UnsubscribeByAttributesRequest' => ['events'],
               'Session::UnsubscribeByIDRequest' => ['subscriptions']
             )
+            object_only
           end
 
+          def capabilities_request(**) = CapabilitiesRequest.new(**)
+          def capability_request(**) = CapabilityRequest.new(**)
+          def proxy_configuration = ProxyConfiguration
+          def autodetect_proxy_configuration(**) = AutodetectProxyConfiguration.new(**)
+          def direct_proxy_configuration(**) = DirectProxyConfiguration.new(**)
+          def manual_proxy_configuration(**) = ManualProxyConfiguration.new(**)
+          def pac_proxy_configuration(**) = PacProxyConfiguration.new(**)
+          def system_proxy_configuration(**) = SystemProxyConfiguration.new(**)
+          def user_prompt_handler(**) = UserPromptHandler.new(**)
+          def unsubscribe_by_id_request(**) = UnsubscribeByIDRequest.new(**)
+          def unsubscribe_by_attributes_request(**) = UnsubscribeByAttributesRequest.new(**)
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-session-end
           def end_
             execute(cmd: 'session.end')
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-session-new
           def new(capabilities:)
             params = NewParameters.new(capabilities: capabilities)
             execute(cmd: 'session.new', params: params, result: Session::NewResult)
@@ -217,12 +259,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-session-status
           def status
             execute(cmd: 'session.status', result: Session::StatusResult)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-session-subscribe
           def subscribe(events:, contexts: Serialization::UNSET, user_contexts: Serialization::UNSET)
             params = SubscribeParameters.new(events: events, contexts: contexts, user_contexts: user_contexts)
             execute(cmd: 'session.subscribe', params: params, result: Session::SubscribeResult)
@@ -230,6 +274,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-session-unsubscribe
           def unsubscribe(events: Serialization::UNSET, subscriptions: Serialization::UNSET)
             params = UnsubscribeParameters.build(events: events, subscriptions: subscriptions)
             execute(cmd: 'session.unsubscribe', params: params)

data/lib/selenium/webdriver/bidi/protocol/speculation.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
@@ -31,6 +31,7 @@ module Selenium
             prefetch_status_updated: 'speculation.prefetchStatusUpdated'
           }.freeze
 
+          # @see https://wicg.github.io/nav-speculation/prefetch.html#cddl-type-speculationpreloadingstatus
           PRELOADING_STATUS = {
             pending: 'pending',
             ready: 'ready',
@@ -40,6 +41,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://wicg.github.io/nav-speculation/prefetch.html#cddl-type-speculationprefetchstatusupdatedparameters
           PrefetchStatusUpdatedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             url: {wire_key: 'url', primitive: 'string'},

data/lib/selenium/webdriver/bidi/protocol/storage.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,9 +26,11 @@ module Selenium
       module Protocol
         # @api private
         # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        # @see https://w3c.github.io/webdriver-bidi/#module-storage
         class Storage < Domain
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#type-storage-PartitionKey
           PartitionKey = Serialization::Record.define(
             user_context: {wire_key: 'userContext', required: false, primitive: 'string'},
             source_origin: {wire_key: 'sourceOrigin', required: false, primitive: 'string'},
@@ -37,28 +39,31 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagecookiefilter
           CookieFilter = Serialization::Record.define(
             name: {wire_key: 'name', required: false, primitive: 'string'},
             value: {wire_key: 'value', required: false, ref: 'Network::BytesValue'},
             domain: {wire_key: 'domain', required: false, primitive: 'string'},
             path: {wire_key: 'path', required: false, primitive: 'string'},
-            size: {wire_key: 'size', required: false},
+            size: {wire_key: 'size', required: false, primitive: 'integer'},
             http_only: {wire_key: 'httpOnly', required: false, primitive: 'boolean'},
             secure: {wire_key: 'secure', required: false, primitive: 'boolean'},
             same_site: {wire_key: 'sameSite', required: false, enum: 'Network::SAME_SITE'},
-            expiry: {wire_key: 'expiry', required: false},
+            expiry: {wire_key: 'expiry', required: false, primitive: 'integer'},
             extensible: true
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagebrowsingcontextpartitiondescriptor
           BrowsingContextPartitionDescriptor = Serialization::Record.define(
             type: {fixed: 'context'},
-            context: 'context'
+            context: {wire_key: 'context', primitive: 'string'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagestoragekeypartitiondescriptor
           StorageKeyPartitionDescriptor = Serialization::Record.define(
             type: {fixed: 'storageKey'},
             user_context: {wire_key: 'userContext', required: false, primitive: 'string'},
@@ -68,16 +73,22 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagepartitiondescriptor
           class PartitionDescriptor < Serialization::Union
             discriminator 'type', {context: 'context', storage_key: 'storageKey'}
             variants(
               context: 'Storage::BrowsingContextPartitionDescriptor',
               storage_key: 'Storage::StorageKeyPartitionDescriptor'
             )
+            object_only
+
+            def self.context(**) = Storage::BrowsingContextPartitionDescriptor.new(**)
+            def self.storage_key(**) = Storage::StorageKeyPartitionDescriptor.new(**)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagegetcookiesparameters
           GetCookiesParameters = Serialization::Record.define(
             filter: {wire_key: 'filter', required: false, ref: 'Storage::CookieFilter'},
             partition: {wire_key: 'partition', required: false, ref: 'Storage::PartitionDescriptor'}
@@ -85,6 +96,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagegetcookiesresult
           GetCookiesResult = Serialization::Record.define(
             cookies: {wire_key: 'cookies', ref: 'Network::Cookie', list: true},
             partition_key: {wire_key: 'partitionKey', ref: 'Storage::PartitionKey'}
@@ -92,6 +104,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagepartialcookie
           PartialCookie = Serialization::Record.define(
             name: {wire_key: 'name', primitive: 'string'},
             value: {wire_key: 'value', ref: 'Network::BytesValue'},
@@ -100,12 +113,13 @@ module Selenium
             http_only: {wire_key: 'httpOnly', required: false, primitive: 'boolean'},
             secure: {wire_key: 'secure', required: false, primitive: 'boolean'},
             same_site: {wire_key: 'sameSite', required: false, enum: 'Network::SAME_SITE'},
-            expiry: {wire_key: 'expiry', required: false},
+            expiry: {wire_key: 'expiry', required: false, primitive: 'integer'},
             extensible: true
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagesetcookieparameters
           SetCookieParameters = Serialization::Record.define(
             cookie: {wire_key: 'cookie', ref: 'Storage::PartialCookie'},
             partition: {wire_key: 'partition', required: false, ref: 'Storage::PartitionDescriptor'}
@@ -113,12 +127,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagesetcookieresult
           SetCookieResult = Serialization::Record.define(
             partition_key: {wire_key: 'partitionKey', ref: 'Storage::PartitionKey'}
           )
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagedeletecookiesparameters
           DeleteCookiesParameters = Serialization::Record.define(
             filter: {wire_key: 'filter', required: false, ref: 'Storage::CookieFilter'},
             partition: {wire_key: 'partition', required: false, ref: 'Storage::PartitionDescriptor'}
@@ -126,12 +142,20 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-storagedeletecookiesresult
           DeleteCookiesResult = Serialization::Record.define(
             partition_key: {wire_key: 'partitionKey', ref: 'Storage::PartitionKey'}
           )
 
+          def cookie_filter(**) = CookieFilter.new(**)
+          def browsing_context_partition_descriptor(**) = BrowsingContextPartitionDescriptor.new(**)
+          def storage_key_partition_descriptor(**) = StorageKeyPartitionDescriptor.new(**)
+          def partition_descriptor = PartitionDescriptor
+          def partial_cookie(**) = PartialCookie.new(**)
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-storage-deleteCookies
           def delete_cookies(filter: Serialization::UNSET, partition: Serialization::UNSET)
             params = DeleteCookiesParameters.new(filter: filter, partition: partition)
             execute(cmd: 'storage.deleteCookies', params: params, result: Storage::DeleteCookiesResult)
@@ -139,6 +163,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-storage-getCookies
           def get_cookies(filter: Serialization::UNSET, partition: Serialization::UNSET)
             params = GetCookiesParameters.new(filter: filter, partition: partition)
             execute(cmd: 'storage.getCookies', params: params, result: Storage::GetCookiesResult)
@@ -146,6 +171,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-storage-setCookie
           def set_cookie(cookie:, partition: Serialization::UNSET)
             params = SetCookieParameters.new(cookie: cookie, partition: partition)
             execute(cmd: 'storage.setCookie', params: params, result: Storage::SetCookieResult)

data/lib/selenium/webdriver/bidi/protocol/user_agent_client_hints.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
@@ -29,6 +29,7 @@ module Selenium
         class UserAgentClientHints < Domain
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://wicg.github.io/ua-client-hints/#cddl-type-useragentclienthintsclienthintsmetadata
           ClientHintsMetadata = Serialization::Record.define(
             brands: {wire_key: 'brands', required: false, ref: 'UserAgentClientHints::BrandVersion', list: true},
             full_version_list: {
@@ -49,6 +50,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://wicg.github.io/ua-client-hints/#cddl-type-useragentclienthintsbrandversion
           BrandVersion = Serialization::Record.define(
             brand: {wire_key: 'brand', primitive: 'string'},
             version: {wire_key: 'version', primitive: 'string'}
@@ -62,6 +64,9 @@ module Selenium
             user_contexts: {wire_key: 'userContexts', required: false, list: true}
           )
 
+          def client_hints_metadata(**) = ClientHintsMetadata.new(**)
+          def brand_version(**) = BrandVersion.new(**)
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           def set_client_hints_override(

data/lib/selenium/webdriver/bidi/protocol/web_extension.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,15 +26,11 @@ module Selenium
       module Protocol
         # @api private
         # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        # @see https://w3c.github.io/webdriver-bidi/#module-webExtension
         class WebExtension < Domain
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          InstallParameters = Serialization::Record.define(
-            extension_data: {wire_key: 'extensionData', ref: 'WebExtension::ExtensionData'}
-          )
-
-          # @api private
-          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionextensiondata
           class ExtensionData < Serialization::Union
             discriminator 'type', {archive_path: 'archivePath', base64: 'base64', path: 'path'}
             variants(
@@ -42,10 +38,16 @@ module Selenium
               base64: 'WebExtension::ExtensionBase64Encoded',
               path: 'WebExtension::ExtensionPath'
             )
+            object_only
+
+            def self.archive_path(**) = WebExtension::ExtensionArchivePath.new(**)
+            def self.base64(**) = WebExtension::ExtensionBase64Encoded.new(**)
+            def self.path(**) = WebExtension::ExtensionPath.new(**)
           end
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionextensionpath
           ExtensionPath = Serialization::Record.define(
             type: {fixed: 'path'},
             path: {wire_key: 'path', primitive: 'string'}
@@ -53,6 +55,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionextensionarchivepath
           ExtensionArchivePath = Serialization::Record.define(
             type: {fixed: 'archivePath'},
             path: {wire_key: 'path', primitive: 'string'}
@@ -60,6 +63,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionextensionbase64encoded
           ExtensionBase64Encoded = Serialization::Record.define(
             type: {fixed: 'base64'},
             value: {wire_key: 'value', primitive: 'string'}
@@ -67,14 +71,31 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          InstallResult = Serialization::Record.define(extension: 'extension')
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensioninstallresult
+          InstallResult = Serialization::Record.define(extension: {wire_key: 'extension', primitive: 'string'})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          UninstallParameters = Serialization::Record.define(extension: 'extension')
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionuninstallparameters
+          UninstallParameters = Serialization::Record.define(extension: {wire_key: 'extension', primitive: 'string'})
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensioninstallparameters
+          InstallParameters = Serialization::Record.define(
+            extension_data: {wire_key: 'extensionData', ref: 'WebExtension::ExtensionData'},
+            extensible: true
+          )
+
+          def extension_data = ExtensionData
+          def extension_path(**) = ExtensionPath.new(**)
+          def extension_archive_path(**) = ExtensionArchivePath.new(**)
+          def extension_base64_encoded(**) = ExtensionBase64Encoded.new(**)
+          def moz = Moz.new(connection)
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-webExtension-install
           def install(extension_data:)
             params = InstallParameters.new(extension_data: extension_data)
             execute(cmd: 'webExtension.install', params: params, result: WebExtension::InstallResult)
@@ -82,10 +103,28 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-webExtension-uninstall
           def uninstall(extension:)
             params = UninstallParameters.new(extension: extension)
             execute(cmd: 'webExtension.uninstall', params: params)
           end
+
+          # @api private
+          # moz: vendor variant of WebExtension, overriding commands with browser-specific params.
+          # Construct Moz.new(source) for a matching session; other sessions use WebExtension.
+          class Moz < WebExtension
+            # @api private
+            # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+            # @see https://w3c.github.io/webdriver-bidi/#command-webExtension-install
+            def install(extension_data:, allow_private_browsing: Serialization::UNSET, permanent: Serialization::UNSET)
+              extensions = {
+                'moz:allowPrivateBrowsing' => allow_private_browsing,
+                'moz:permanent' => permanent
+              }.reject { |_, value| Serialization::UNSET.equal?(value) }
+              params = InstallParameters.new(extension_data: extension_data, extensions: extensions)
+              execute(cmd: 'webExtension.install', params: params, result: WebExtension::InstallResult)
+            end
+          end
         end # WebExtension
       end # Protocol
     end # BiDi

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

@@ -20,9 +20,12 @@
 # serialization must load first (it defines the Serialization runtime the generated
 # classes build on), then the Domain base the generated classes subclass. Add a require
 # below when a new BiDi domain is generated.
+require 'selenium/webdriver/common/error'
 require 'selenium/webdriver/bidi/serialization'
 require 'selenium/webdriver/bidi/transport'
 require 'selenium/webdriver/bidi/protocol/domain'
+require 'selenium/webdriver/bidi/protocol/error_code'
+require 'selenium/webdriver/bidi/error'
 require 'selenium/webdriver/bidi/protocol/bluetooth'
 require 'selenium/webdriver/bidi/protocol/browser'
 require 'selenium/webdriver/bidi/protocol/browsing_context'