selenium-webdriver 4.49.0 → 4.50.0

data/lib/selenium/webdriver/atoms/findElements.js

@@ -64,7 +64,16 @@
         if (target === '') {
             throw botError(INVALID_SELECTOR, 'Unable to locate an element with the tagName ""');
         }
-        return Array.from(root.getElementsByTagName(target));
+        if ('getElementsByTagName' in root) {
+            return Array.from(root.getElementsByTagName(target));
+        }
+        const elements = Array.from(root.querySelectorAll('*'));
+        if (target === '*') {
+            return elements;
+        }
+        const html = 'http://www.w3.org/1999/xhtml';
+        const folded = target.toLowerCase();
+        return elements.filter(el => el.namespaceURI === html ? el.localName === folded : el.localName === target);
     }
     const DEFAULT_NS_RESOLVER = (function () {
         const ns = { svg: 'http://www.w3.org/2000/svg' };
@@ -147,7 +156,10 @@
             return resolveAnchor(selector());
         }
         if (selector && typeof selector === 'object') {
-            const found = findElements(selector);
+            let found = root ? findElements(selector, root) : [];
+            if (!found.length) {
+                found = findElements(selector);
+            }
             if (!found.length) {
                 throw botError(NO_SUCH_ELEMENT, 'No element has been found by ' + JSON.stringify(selector));
             }

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

@@ -29,7 +29,9 @@ module Selenium
         class Bluetooth < Domain
           EVENTS = {
             request_device_prompt_updated: 'bluetooth.requestDevicePromptUpdated',
-            gatt_connection_attempted: 'bluetooth.gattConnectionAttempted'
+            gatt_connection_attempted: 'bluetooth.gattConnectionAttempted',
+            characteristic_event_generated: 'bluetooth.characteristicEventGenerated',
+            descriptor_event_generated: 'bluetooth.descriptorEventGenerated'
           }.freeze
 
           SIMULATE_ADAPTER_PARAMETERS_STATE = {
@@ -80,7 +82,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothbluetoothmanufacturerdata
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothbluetoothmanufacturerdata
           BluetoothManufacturerData = Serialization::Record.define(
             key: {wire_key: 'key', primitive: 'integer'},
             data: {wire_key: 'data', primitive: 'string'}
@@ -88,7 +90,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothcharacteristicproperties
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothcharacteristicproperties
           CharacteristicProperties = Serialization::Record.define(
             broadcast: {wire_key: 'broadcast', required: false, primitive: 'boolean'},
             read: {wire_key: 'read', required: false, primitive: 'boolean'},
@@ -102,7 +104,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothrequestdeviceinfo
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothrequestdeviceinfo
           RequestDeviceInfo = Serialization::Record.define(
             id: {wire_key: 'id', primitive: 'string'},
             name: {wire_key: 'name', nullable: true, primitive: 'string'}
@@ -110,7 +112,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothscanrecord
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothscanrecord
           ScanRecord = Serialization::Record.define(
             name: {wire_key: 'name', required: false, primitive: 'string'},
             uuids: {wire_key: 'uuids', required: false, list: true},
@@ -125,7 +127,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothhandlerequestdevicepromptparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothhandlerequestdevicepromptparameters
           class HandleRequestDevicePromptParameters < Serialization::Union
             discriminator 'accept'
             variants(
@@ -157,7 +159,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadapterparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulateadapterparameters
           SimulateAdapterParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             le_supported: {wire_key: 'leSupported', required: false, primitive: 'boolean'},
@@ -166,14 +168,14 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothdisablesimulationparameters
+          # @see https://bluetooth.spec.whatwg.org/#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
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulatepreconnectedperipheralparameters
           SimulatePreconnectedPeripheralParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -184,7 +186,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadvertisementparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulateadvertisementparameters
           SimulateAdvertisementParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             scan_entry: {wire_key: 'scanEntry', ref: 'Bluetooth::SimulateAdvertisementScanEntryParameters'}
@@ -192,7 +194,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateadvertisementscanentryparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulateadvertisementscanentryparameters
           SimulateAdvertisementScanEntryParameters = Serialization::Record.define(
             device_address: {wire_key: 'deviceAddress', primitive: 'string'},
             rssi: {wire_key: 'rssi', primitive: 'number'},
@@ -201,7 +203,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulategattconnectionresponseparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulategattconnectionresponseparameters
           SimulateGattConnectionResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -210,7 +212,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulategattdisconnectionparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulategattdisconnectionparameters
           SimulateGattDisconnectionParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'}
@@ -218,7 +220,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulateserviceparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulateserviceparameters
           SimulateServiceParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -228,7 +230,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatecharacteristicparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulatecharacteristicparameters
           SimulateCharacteristicParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -244,7 +246,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatecharacteristicresponseparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulatecharacteristicresponseparameters
           SimulateCharacteristicResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -257,7 +259,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatedescriptorparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulatedescriptorparameters
           SimulateDescriptorParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -269,7 +271,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothsimulatedescriptorresponseparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothsimulatedescriptorresponseparameters
           SimulateDescriptorResponseParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -283,7 +285,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothrequestdevicepromptupdatedparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothrequestdevicepromptupdatedparameters
           RequestDevicePromptUpdatedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             prompt: {wire_key: 'prompt', primitive: 'string'},
@@ -292,7 +294,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothgattconnectionattemptedparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothgattconnectionattemptedparameters
           GattConnectionAttemptedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'}
@@ -300,7 +302,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothcharacteristiceventgeneratedparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothcharacteristiceventgeneratedparameters
           CharacteristicEventGeneratedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -312,7 +314,7 @@ module Selenium
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
-          # @see https://webbluetoothcg.github.io/web-bluetooth/#cddl-type-bluetoothdescriptoreventgeneratedparameters
+          # @see https://bluetooth.spec.whatwg.org/#cddl-type-bluetoothdescriptoreventgeneratedparameters
           DescriptorEventGeneratedParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
             address: {wire_key: 'address', primitive: 'string'},
@@ -325,7 +327,9 @@ module Selenium
 
           EVENT_TYPES = {
             'bluetooth.requestDevicePromptUpdated' => Bluetooth::RequestDevicePromptUpdatedParameters,
-            'bluetooth.gattConnectionAttempted' => Bluetooth::GattConnectionAttemptedParameters
+            'bluetooth.gattConnectionAttempted' => Bluetooth::GattConnectionAttemptedParameters,
+            'bluetooth.characteristicEventGenerated' => Bluetooth::CharacteristicEventGeneratedParameters,
+            'bluetooth.descriptorEventGenerated' => Bluetooth::DescriptorEventGeneratedParameters
           }.freeze
 
           def bluetooth_manufacturer_data(**) = BluetoothManufacturerData.new(**)

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

@@ -81,6 +81,19 @@ module Selenium
             landscape: 'landscape'
           }.freeze
 
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsingcontextbaseinfo
+          BaseInfo = Serialization::Record.define(
+            children: {wire_key: 'children', nullable: true, ref: 'BrowsingContext::Info', list: true},
+            client_window: {wire_key: 'clientWindow', primitive: 'string'},
+            context: {wire_key: 'context', primitive: 'string'},
+            original_opener: {wire_key: 'originalOpener', nullable: true, primitive: 'string'},
+            url: {wire_key: 'url', primitive: 'string'},
+            user_context: {wire_key: 'userContext', primitive: 'string'},
+            parent: {wire_key: 'parent', required: false, nullable: true, primitive: 'string'}
+          )
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           # @see https://w3c.github.io/webdriver-bidi/#type-browsingContext-Info
@@ -91,7 +104,8 @@ module Selenium
             original_opener: {wire_key: 'originalOpener', nullable: true, primitive: 'string'},
             url: {wire_key: 'url', primitive: 'string'},
             user_context: {wire_key: 'userContext', primitive: 'string'},
-            parent: {wire_key: 'parent', required: false, nullable: true, primitive: 'string'}
+            parent: {wire_key: 'parent', required: false, nullable: true, primitive: 'string'},
+            extensible: true
           )
 
           # @api private
@@ -299,7 +313,8 @@ module Selenium
           # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsingcontextgettreeparameters
           GetTreeParameters = Serialization::Record.define(
             max_depth: {wire_key: 'maxDepth', required: false, primitive: 'integer'},
-            root: {wire_key: 'root', required: false, primitive: 'string'}
+            root: {wire_key: 'root', required: false, primitive: 'string'},
+            extensible: true
           )
 
           # @api private
@@ -439,6 +454,7 @@ module Selenium
           # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsingcontextstartscreencastparameters
           StartScreencastParameters = Serialization::Record.define(
             context: {wire_key: 'context', primitive: 'string'},
+            destination_folder: {wire_key: 'destinationFolder', required: false, primitive: 'string'},
             mime_type: {wire_key: 'mimeType', required: false, primitive: 'string'},
             video: {wire_key: 'video', required: false, ref: 'BrowsingContext::MediaTrackConstraints'},
             audio: {wire_key: 'audio', required: false, primitive: 'boolean'}
@@ -570,8 +586,22 @@ module Selenium
             default_value: {wire_key: 'defaultValue', required: false, primitive: 'string'}
           )
 
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-browsingcontextcontextcreatedparameters
+          ContextCreatedParameters = Serialization::Record.define(
+            children: {wire_key: 'children', nullable: true, ref: 'BrowsingContext::Info', list: true},
+            client_window: {wire_key: 'clientWindow', primitive: 'string'},
+            context: {wire_key: 'context', primitive: 'string'},
+            original_opener: {wire_key: 'originalOpener', nullable: true, primitive: 'string'},
+            url: {wire_key: 'url', primitive: 'string'},
+            user_context: {wire_key: 'userContext', primitive: 'string'},
+            parent: {wire_key: 'parent', required: false, nullable: true, primitive: 'string'},
+            has_planned_navigation: {wire_key: 'hasPlannedNavigation', required: false, primitive: 'boolean'}
+          )
+
           EVENT_TYPES = {
-            'browsingContext.contextCreated' => BrowsingContext::Info,
+            'browsingContext.contextCreated' => BrowsingContext::ContextCreatedParameters,
             'browsingContext.contextDestroyed' => BrowsingContext::Info,
             'browsingContext.domContentLoaded' => BrowsingContext::NavigationInfo,
             'browsingContext.downloadEnd' => BrowsingContext::DownloadEndParams,
@@ -604,6 +634,7 @@ module Selenium
           def media_track_constraints(**) = MediaTrackConstraints.new(**)
           def accessibility_locator_value(**) = AccessibilityLocator::Value.new(**)
           def context_locator_value(**) = ContextLocator::Value.new(**)
+          def moz = Moz.new(connection)
 
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
@@ -777,11 +808,18 @@ module Selenium
           # @see https://w3c.github.io/webdriver-bidi/#command-browsingContext-startScreencast
           def start_screencast(
             context:,
+            destination_folder: Serialization::UNSET,
             mime_type: Serialization::UNSET,
             video: Serialization::UNSET,
             audio: Serialization::UNSET
           )
-            params = StartScreencastParameters.new(context: context, mime_type: mime_type, video: video, audio: audio)
+            params = StartScreencastParameters.new(
+              context: context,
+              destination_folder: destination_folder,
+              mime_type: mime_type,
+              video: video,
+              audio: audio
+            )
             execute(
               cmd: 'browsingContext.startScreencast',
               params: params,
@@ -808,6 +846,22 @@ module Selenium
             params = TraverseHistoryParameters.new(context: context, delta: delta)
             execute(cmd: 'browsingContext.traverseHistory', params: params)
           end
+
+          # @api private
+          # moz: vendor variant of BrowsingContext, with browser-specific commands and params.
+          # Construct Moz.new(source) for a matching session; other sessions use BrowsingContext.
+          class Moz < BrowsingContext
+            # @api private
+            # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+            # @see https://w3c.github.io/webdriver-bidi/#command-browsingContext-getTree
+            def get_tree(max_depth: Serialization::UNSET, root: Serialization::UNSET, scope: Serialization::UNSET)
+              extensions = {
+                'moz:scope' => scope
+              }.reject { |_, value| Serialization::UNSET.equal?(value) }
+              params = GetTreeParameters.new(max_depth: max_depth, root: root, extensions: extensions)
+              execute(cmd: 'browsingContext.getTree', params: params, result: BrowsingContext::GetTreeResult)
+            end
+          end
         end # BrowsingContext
       end # Protocol
     end # BiDi

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

@@ -0,0 +1,69 @@
+# 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 DigitalCredentials < Domain
+          # @see https://w3c-fedid.github.io/digital-credentials/#cddl-type-digitalcredentials-virtualwalletaction
+          VIRTUAL_WALLET_ACTION = {
+            decline: 'decline',
+            respond: 'respond',
+            wait: 'wait',
+            clear: 'clear'
+          }.freeze
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c-fedid.github.io/digital-credentials/#cddl-type-digitalcredentials-setvirtualwalletbehaviorparameters
+          SetVirtualWalletBehaviorParameters = Serialization::Record.define(
+            action: {wire_key: 'action', enum: 'DigitalCredentials::VIRTUAL_WALLET_ACTION'},
+            context: {wire_key: 'context', required: false, primitive: 'string'},
+            protocol: {wire_key: 'protocol', required: false, primitive: 'string'},
+            response: {wire_key: 'response', required: false}
+          )
+
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          def set_virtual_wallet_behavior(
+            action:,
+            context: Serialization::UNSET,
+            protocol: Serialization::UNSET,
+            response: Serialization::UNSET
+          )
+            Serialization.validate!('action', action, DigitalCredentials::VIRTUAL_WALLET_ACTION)
+            params = SetVirtualWalletBehaviorParameters.new(
+              action: action,
+              context: context,
+              protocol: protocol,
+              response: response
+            )
+            execute(cmd: 'digitalCredentials.setVirtualWalletBehavior', params: params)
+          end
+        end # DigitalCredentials
+      end # Protocol
+    end # BiDi
+  end # WebDriver
+end # Selenium

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

@@ -48,6 +48,11 @@ module Selenium
             landscape_secondary: 'landscape-secondary'
           }.freeze
 
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-emulationtextlayoutmode
+          TEXT_LAYOUT_MODE = {
+            mobile: 'mobile'
+          }.freeze
+
           MEDIA_FEATURES_ANY_HOVER = {
             none: 'none',
             hover: 'hover'
@@ -491,6 +496,15 @@ module Selenium
             user_contexts: {wire_key: 'userContexts', required: false, list: true}
           )
 
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#cddl-type-emulationsettextlayoutmodeoverrideparameters
+          SetTextLayoutModeOverrideParameters = Serialization::Record.define(
+            text_layout_mode: {wire_key: 'textLayoutMode', nullable: true, enum: 'Emulation::TEXT_LAYOUT_MODE'},
+            contexts: {wire_key: 'contexts', required: false, list: true},
+            user_contexts: {wire_key: 'userContexts', required: false, list: true}
+          )
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           # @see https://w3c.github.io/webdriver-bidi/#cddl-type-emulationsettimezoneoverrideparameters
@@ -656,6 +670,23 @@ module Selenium
             execute(cmd: 'emulation.setScrollbarTypeOverride', params: params)
           end
 
+          # @api private
+          # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
+          # @see https://w3c.github.io/webdriver-bidi/#command-emulation-setTextLayoutModeOverride
+          def set_text_layout_mode_override(
+            text_layout_mode:,
+            contexts: Serialization::UNSET,
+            user_contexts: Serialization::UNSET
+          )
+            Serialization.validate!('textLayoutMode', text_layout_mode, Emulation::TEXT_LAYOUT_MODE)
+            params = SetTextLayoutModeOverrideParameters.new(
+              text_layout_mode: text_layout_mode,
+              contexts: contexts,
+              user_contexts: user_contexts
+            )
+            execute(cmd: 'emulation.setTextLayoutModeOverride', params: params)
+          end
+
           # @api private
           # @see https://www.selenium.dev/documentation/warnings/bidi-implementation/
           # @see https://w3c.github.io/webdriver-bidi/#command-emulation-setTimezoneOverride