selenium-webdriver 4.49.0 → 4.50.0

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

@@ -0,0 +1,334 @@
+# frozen_string_literal: true
+
+# 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.
+
+# 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
+    class BiDi
+      module Protocol
+        # @api private
+        # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        class MozDebugging < Domain
+          EVENTS = {
+            paused: 'moz:debugging.paused',
+            resumed: 'moz:debugging.resumed'
+          }.freeze
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          GetScriptSourceParameters = Serialization::Record.define(
+            context: {wire_key: 'context', primitive: 'string'},
+            script_url: {wire_key: 'scriptUrl', primitive: 'string'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          GetScriptSourceResult = Serialization::Record.define(source: {wire_key: 'source', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          ListScriptsParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          ListScriptsResult = Serialization::Record.define(scripts: {wire_key: 'scripts', list: true})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          RemoveBreakpointParameters = Serialization::Record.define(
+            breakpoint: {wire_key: 'breakpoint', primitive: 'string'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          ResumeParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          SetBreakpointParameters = Serialization::Record.define(
+            location: {wire_key: 'location', ref: 'MozDebugging::SetBreakpointParameters::Location'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          SetBreakpointParameters::Location = Serialization::Record.define(
+            line: {wire_key: 'line', primitive: 'integer'},
+            url: {wire_key: 'url', primitive: 'string'},
+            column: {wire_key: 'column', required: false, primitive: 'integer'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          SetBreakpointResult = Serialization::Record.define(breakpoint: {wire_key: 'breakpoint', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          BaseLocation = Serialization::Record.define(
+            line: {wire_key: 'line', primitive: 'integer'},
+            url: {wire_key: 'url', primitive: 'string'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          SetDebuggerEnabledParameters = Serialization::Record.define(
+            contexts: {wire_key: 'contexts', required: false, list: true},
+            enabled: {wire_key: 'enabled', nullable: true, primitive: 'boolean'},
+            user_contexts: {wire_key: 'userContexts', required: false, list: true}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          StepIntoParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          StepOutParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          StepOverParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParameters = Serialization::Record.define(
+            context: {wire_key: 'context', primitive: 'string'},
+            url: {wire_key: 'url', primitive: 'string'},
+            line: {wire_key: 'line', primitive: 'integer'},
+            column: {wire_key: 'column', primitive: 'integer'},
+            call_frames: {wire_key: 'callFrames', ref: 'MozDebugging::PausedParametersCallFrame', list: true}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersCallFrame = Serialization::Record.define(
+            call_frame_id: {wire_key: 'callFrameId', primitive: 'string'},
+            function_name: {wire_key: 'functionName', primitive: 'string'},
+            location: {wire_key: 'location', ref: 'MozDebugging::PausedParametersCallFrame::Location'},
+            scope_chain: {wire_key: 'scopeChain', ref: 'MozDebugging::PausedParametersScope', list: true}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersCallFrame::Location = Serialization::Record.define(
+            line: {wire_key: 'line', primitive: 'integer'},
+            url: {wire_key: 'url', primitive: 'string'},
+            column: {wire_key: 'column', primitive: 'integer'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersScope = Serialization::Record.define(
+            type: {wire_key: 'type', primitive: 'string'},
+            variables: 'variables'
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          class PausedParametersScopeValue < Serialization::Union
+            discriminator 'type', {
+              missing_arguments: 'missingArguments',
+              optimized_out: 'optimizedOut',
+              uninitialized: 'uninitialized',
+              undefined: 'undefined',
+              null: 'null',
+              string: 'string',
+              number: 'number',
+              boolean: 'boolean',
+              bigint: 'bigint',
+              symbol: 'symbol',
+              array: 'array',
+              object: 'object',
+              function: 'function',
+              regexp: 'regexp',
+              date: 'date',
+              map: 'map',
+              set: 'set',
+              weakmap: 'weakmap',
+              weakset: 'weakset',
+              generator: 'generator',
+              error: 'error',
+              proxy: 'proxy',
+              promise: 'promise',
+              typedarray: 'typedarray',
+              arraybuffer: 'arraybuffer',
+              nodelist: 'nodelist',
+              htmlcollection: 'htmlcollection',
+              node: 'node',
+              window: 'window'
+            }
+            variants(
+              missing_arguments: 'MozDebugging::PausedParametersScopeValueMissingArguments',
+              optimized_out: 'MozDebugging::PausedParametersScopeValueOptimizedOut',
+              uninitialized: 'MozDebugging::PausedParametersScopeValueUninitialized',
+              undefined: 'Script::UndefinedValue',
+              null: 'Script::NullValue',
+              string: 'Script::StringValue',
+              number: 'Script::NumberValue',
+              boolean: 'Script::BooleanValue',
+              bigint: 'Script::BigIntValue',
+              symbol: 'Script::SymbolRemoteValue',
+              array: 'Script::ArrayRemoteValue',
+              object: 'Script::ObjectRemoteValue',
+              function: 'Script::FunctionRemoteValue',
+              regexp: 'Script::RegExpRemoteValue',
+              date: 'Script::DateRemoteValue',
+              map: 'Script::MapRemoteValue',
+              set: 'Script::SetRemoteValue',
+              weakmap: 'Script::WeakMapRemoteValue',
+              weakset: 'Script::WeakSetRemoteValue',
+              generator: 'Script::GeneratorRemoteValue',
+              error: 'Script::ErrorRemoteValue',
+              proxy: 'Script::ProxyRemoteValue',
+              promise: 'Script::PromiseRemoteValue',
+              typedarray: 'Script::TypedArrayRemoteValue',
+              arraybuffer: 'Script::ArrayBufferRemoteValue',
+              nodelist: 'Script::NodeListRemoteValue',
+              htmlcollection: 'Script::HTMLCollectionRemoteValue',
+              node: 'Script::NodeRemoteValue',
+              window: 'Script::WindowProxyRemoteValue'
+            )
+            object_only
+
+            def self.missing_arguments(**) = MozDebugging::PausedParametersScopeValueMissingArguments.new(**)
+            def self.optimized_out(**) = MozDebugging::PausedParametersScopeValueOptimizedOut.new(**)
+            def self.uninitialized(**) = MozDebugging::PausedParametersScopeValueUninitialized.new(**)
+            def self.undefined(**) = Script::UndefinedValue.new(**)
+            def self.null(**) = Script::NullValue.new(**)
+            def self.string(**) = Script::StringValue.new(**)
+            def self.number(**) = Script::NumberValue.new(**)
+            def self.boolean(**) = Script::BooleanValue.new(**)
+            def self.bigint(**) = Script::BigIntValue.new(**)
+            def self.symbol(**) = Script::SymbolRemoteValue.new(**)
+            def self.array(**) = Script::ArrayRemoteValue.new(**)
+            def self.object(**) = Script::ObjectRemoteValue.new(**)
+            def self.function(**) = Script::FunctionRemoteValue.new(**)
+            def self.regexp(**) = Script::RegExpRemoteValue.new(**)
+            def self.date(**) = Script::DateRemoteValue.new(**)
+            def self.map(**) = Script::MapRemoteValue.new(**)
+            def self.set(**) = Script::SetRemoteValue.new(**)
+            def self.weakmap(**) = Script::WeakMapRemoteValue.new(**)
+            def self.weakset(**) = Script::WeakSetRemoteValue.new(**)
+            def self.generator(**) = Script::GeneratorRemoteValue.new(**)
+            def self.error(**) = Script::ErrorRemoteValue.new(**)
+            def self.proxy(**) = Script::ProxyRemoteValue.new(**)
+            def self.promise(**) = Script::PromiseRemoteValue.new(**)
+            def self.typedarray(**) = Script::TypedArrayRemoteValue.new(**)
+            def self.arraybuffer(**) = Script::ArrayBufferRemoteValue.new(**)
+            def self.nodelist(**) = Script::NodeListRemoteValue.new(**)
+            def self.htmlcollection(**) = Script::HTMLCollectionRemoteValue.new(**)
+            def self.node(**) = Script::NodeRemoteValue.new(**)
+            def self.window(**) = Script::WindowProxyRemoteValue.new(**)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersScopeValueMissingArguments = Serialization::Record.define(type: {fixed: 'missingArguments'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersScopeValueOptimizedOut = Serialization::Record.define(type: {fixed: 'optimizedOut'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          PausedParametersScopeValueUninitialized = Serialization::Record.define(type: {fixed: 'uninitialized'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          ResumedParameters = Serialization::Record.define(context: {wire_key: 'context', primitive: 'string'})
+
+          EVENT_TYPES = {
+            'moz:debugging.paused' => MozDebugging::PausedParameters,
+            'moz:debugging.resumed' => MozDebugging::ResumedParameters
+          }.freeze
+
+          def set_breakpoint_parameters_location(**) = SetBreakpointParameters::Location.new(**)
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def get_script_source(context:, script_url:)
+            params = GetScriptSourceParameters.new(context: context, script_url: script_url)
+            execute(cmd: 'moz:debugging.getScriptSource', params: params, result: MozDebugging::GetScriptSourceResult)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def list_scripts(context:)
+            params = ListScriptsParameters.new(context: context)
+            execute(cmd: 'moz:debugging.listScripts', params: params, result: MozDebugging::ListScriptsResult)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def remove_breakpoint(breakpoint:)
+            params = RemoveBreakpointParameters.new(breakpoint: breakpoint)
+            execute(cmd: 'moz:debugging.removeBreakpoint', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def resume(context:)
+            params = ResumeParameters.new(context: context)
+            execute(cmd: 'moz:debugging.resume', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def set_breakpoint(location:)
+            params = SetBreakpointParameters.new(location: location)
+            execute(cmd: 'moz:debugging.setBreakpoint', params: params, result: MozDebugging::SetBreakpointResult)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def set_debugger_enabled(enabled:, contexts: Serialization::UNSET, user_contexts: Serialization::UNSET)
+            params = SetDebuggerEnabledParameters.new(
+              contexts: contexts,
+              enabled: enabled,
+              user_contexts: user_contexts
+            )
+            execute(cmd: 'moz:debugging.setDebuggerEnabled', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def step_into(context:)
+            params = StepIntoParameters.new(context: context)
+            execute(cmd: 'moz:debugging.stepInto', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def step_out(context:)
+            params = StepOutParameters.new(context: context)
+            execute(cmd: 'moz:debugging.stepOut', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def step_over(context:)
+            params = StepOverParameters.new(context: context)
+            execute(cmd: 'moz:debugging.stepOver', params: params)
+          end
+        end # MozDebugging
+      end # Protocol
+    end # BiDi
+  end # WebDriver
+end # Selenium

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

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+# 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.
+
+# 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
+    class BiDi
+      module Protocol
+        # @api private
+        # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+        class MozProfiler < Domain
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          IsActiveResult = Serialization::Record.define(active: {wire_key: 'active', primitive: 'boolean'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          class StartParameters < Serialization::Union
+            presence(
+              'MozProfiler::StartParameters::Preset' => ['preset'],
+              'MozProfiler::StartParameters::Options' => %w[entries interval features threads]
+            )
+            object_only
+
+            # @api private
+            # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+            Preset = Serialization::Record.define(
+              active_context: {wire_key: 'activeContext', required: false, primitive: 'string'},
+              preset: {wire_key: 'preset', primitive: 'string'}
+            )
+
+            # @api private
+            # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+            Options = Serialization::Record.define(
+              active_context: {wire_key: 'activeContext', required: false, primitive: 'string'},
+              entries: {wire_key: 'entries', primitive: 'integer'},
+              interval: {wire_key: 'interval', primitive: 'integer'},
+              features: {wire_key: 'features', list: true},
+              threads: {wire_key: 'threads', list: true}
+            )
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          StopParameters = Serialization::Record.define(
+            discard: {wire_key: 'discard', required: false, primitive: 'boolean'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          StopResult = Serialization::Record.define(path: {wire_key: 'path', nullable: true, primitive: 'string'})
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def is_active
+            execute(cmd: 'moz:profiler.isActive', result: MozProfiler::IsActiveResult)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def start(
+            active_context: Serialization::UNSET,
+            preset: Serialization::UNSET,
+            entries: Serialization::UNSET,
+            interval: Serialization::UNSET,
+            features: Serialization::UNSET,
+            threads: Serialization::UNSET
+          )
+            params = StartParameters.build(
+              active_context: active_context,
+              preset: preset,
+              entries: entries,
+              interval: interval,
+              features: features,
+              threads: threads
+            )
+            execute(cmd: 'moz:profiler.start', params: params)
+          end
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def stop(discard: Serialization::UNSET)
+            params = StopParameters.new(discard: discard)
+            execute(cmd: 'moz:profiler.stop', params: params, result: MozProfiler::StopResult)
+          end
+        end # MozProfiler
+      end # Protocol
+    end # BiDi
+  end # WebDriver
+end # Selenium

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

@@ -28,6 +28,14 @@ module Selenium
         # @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/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensioninstallparameters
+          InstallParameters = Serialization::Record.define(
+            extension_data: {wire_key: 'extensionData', ref: 'WebExtension::ExtensionData'},
+            extensible: true
+          )
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           # @see https://w3c.github.io/webdriver-bidi/#cddl-type-webextensionextensiondata
@@ -81,10 +89,32 @@ module Selenium
 
           # @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
+          MozListExtensionsResult = Serialization::Record.define(
+            extensions: {wire_key: 'extensions', ref: 'WebExtension::MozExtensionInfo', list: true}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          MozExtensionInfo = Serialization::Record.define(
+            id: {wire_key: 'id', primitive: 'string'},
+            name: {wire_key: 'name', primitive: 'string'},
+            version: {wire_key: 'version', primitive: 'string'},
+            manifest_version: {wire_key: 'manifestVersion', primitive: 'integer'},
+            is_active: {wire_key: 'isActive', primitive: 'boolean'},
+            is_system: {wire_key: 'isSystem', primitive: 'boolean'},
+            hidden: {wire_key: 'hidden', primitive: 'boolean'},
+            temporarily_installed: {wire_key: 'temporarilyInstalled', primitive: 'boolean'},
+            source_url: {wire_key: 'sourceURL', required: false, nullable: true, primitive: 'string'},
+            policy: {wire_key: 'policy', required: false, nullable: true, ref: 'WebExtension::MozExtensionPolicyInfo'}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          MozExtensionPolicyInfo = Serialization::Record.define(
+            uuid: {wire_key: 'uuid', primitive: 'string'},
+            base_url: {wire_key: 'baseURL', primitive: 'string'},
+            extension_url: {wire_key: 'extensionURL', primitive: 'string'},
+            background_scripts: {wire_key: 'backgroundScripts', list: true}
           )
 
           def extension_data = ExtensionData
@@ -110,7 +140,7 @@ module Selenium
           end
 
           # @api private
-          # moz: vendor variant of WebExtension, overriding commands with browser-specific params.
+          # moz: vendor variant of WebExtension, with browser-specific commands and params.
           # Construct Moz.new(source) for a matching session; other sessions use WebExtension.
           class Moz < WebExtension
             # @api private
@@ -124,6 +154,12 @@ module Selenium
               params = InstallParameters.new(extension_data: extension_data, extensions: extensions)
               execute(cmd: 'webExtension.install', params: params, result: WebExtension::InstallResult)
             end
+
+            # @api private
+            # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+            def list_extensions
+              execute(cmd: 'webExtension.moz:listExtensions', result: WebExtension::MozListExtensionsResult)
+            end
           end
         end # WebExtension
       end # Protocol

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

@@ -29,9 +29,12 @@ require 'selenium/webdriver/bidi/error'
 require 'selenium/webdriver/bidi/protocol/bluetooth'
 require 'selenium/webdriver/bidi/protocol/browser'
 require 'selenium/webdriver/bidi/protocol/browsing_context'
+require 'selenium/webdriver/bidi/protocol/digital_credentials'
 require 'selenium/webdriver/bidi/protocol/emulation'
 require 'selenium/webdriver/bidi/protocol/input'
 require 'selenium/webdriver/bidi/protocol/log'
+require 'selenium/webdriver/bidi/protocol/moz_debugging'
+require 'selenium/webdriver/bidi/protocol/moz_profiler'
 require 'selenium/webdriver/bidi/protocol/network'
 require 'selenium/webdriver/bidi/protocol/permissions'
 require 'selenium/webdriver/bidi/protocol/script'