playwright-ruby-client 1.52.0 → 1.53.0

data/lib/playwright/locator_assertions_impl.rb

@@ -11,20 +11,20 @@ module Playwright
       end
     end
 
-    def initialize(locator, timeout, is_not, message)
+    def initialize(locator, default_expect_timeout, is_not, message)
       @locator = locator
-      @timeout = timeout
+      @default_expect_timeout = default_expect_timeout
       @is_not = is_not
       @custom_message = message
     end
 
-    private def expect_impl(expression, expect_options, expected, message)
-      expect_options[:timeout] ||= 5000
+    private def expect_impl(expression, expect_options, expected, message, title)
+      expect_options[:timeout] ||= @default_expect_timeout
       expect_options[:isNot] = @is_not
       message.gsub!("expected to", "not expected to") if @is_not
       expect_options.delete(:useInnerText) if expect_options.key?(:useInnerText) && expect_options[:useInnerText].nil?
 
-      result = @locator.expect(expression, expect_options)
+      result = @locator.expect(expression, expect_options, title)
 
       if result["matches"] == @is_not
         actual = result["received"]
@@ -59,7 +59,7 @@ module Playwright
     private def _not # "not" is reserved in Ruby
       LocatorAssertionsImpl.new(
         @locator,
-        @timeout,
+        @default_expect_timeout,
         !@is_not,
         @message
       )
@@ -124,7 +124,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to contain text"
+          "Locator expected to contain text",
+          'Expect "to_contain_text"',
         )
       else
         expected_text = to_expected_text_values(
@@ -142,7 +143,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to contain text"
+          "Locator expected to contain text",
+          'Expect "to_contain_text"',
         )
       end
     end
@@ -157,7 +159,8 @@ module Playwright
           timeout: timeout,
         },
         name,
-        "Locator expected to have accessible name"
+        "Locator expected to have accessible name",
+        'Expect "to_have_accessible_name"',
       )
     end
     _define_negation :to_have_accessible_name
@@ -171,7 +174,8 @@ module Playwright
           timeout: timeout,
         },
         name,
-        "Locator expected to have accessible description"
+        "Locator expected to have accessible description",
+        'Expect "to_have_accessible_description"',
       )
     end
     _define_negation :to_have_accessible_description
@@ -185,7 +189,8 @@ module Playwright
           timeout: timeout,
         },
         errorMessage,
-        "Locator expected to have accessible error message"
+        "Locator expected to have accessible error message",
+        'Expect "to_have_accessible_error_message"',
       )
     end
     _define_negation :to_have_accessible_error_message
@@ -200,7 +205,8 @@ module Playwright
           timeout: timeout,
         },
         value,
-        "Locator expected to have attribute"
+        "Locator expected to have attribute",
+        'Expect "to_have_attribute"',
       )
     end
     _define_negation :to_have_attribute
@@ -215,7 +221,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to have class"
+          "Locator expected to have class",
+          'Expect "to_have_class"',
         )
       else
         expected_text = to_expected_text_values([expected])
@@ -226,7 +233,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to have class"
+          "Locator expected to have class",
+          'Expect "to_have_class"',
         )
       end
     end
@@ -245,7 +253,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to contain class names"
+          "Locator expected to contain class names",
+          'Expect "to_contain_class"',
         )
       else # Single string
         if expected.is_a?(Regexp)
@@ -259,7 +268,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to contain class"
+          "Locator expected to contain class",
+          'Expect "to_contain_class"',
         )
       end
     end
@@ -273,7 +283,8 @@ module Playwright
           timeout: timeout,
         },
         count,
-        "Locator expected to have count"
+        "Locator expected to have count",
+        'Expect "to_have_count"',
       )
     end
     _define_negation :to_have_count
@@ -288,7 +299,8 @@ module Playwright
           timeout: timeout,
         },
         value,
-        "Locator expected to have CSS"
+        "Locator expected to have CSS",
+        'Expect "to_have_css"',
       )
     end
     _define_negation :to_have_css
@@ -302,7 +314,8 @@ module Playwright
           timeout: timeout,
         },
         id,
-        "Locator expected to have ID"
+        "Locator expected to have ID",
+        'Expect "to_have_id"',
       )
     end
     _define_negation :to_have_id
@@ -316,7 +329,8 @@ module Playwright
           timeout: timeout,
         },
         value,
-        "Locator expected to have JS Property"
+        "Locator expected to have JS Property",
+        'Expect "to_have_js_property"',
       )
     end
     _define_negation :to_have_js_property
@@ -335,6 +349,7 @@ module Playwright
         },
         role,
         "Locator expected to have accessible role",
+        'Expect "to_have_role"',
       )
     end
     _define_negation :to_have_role
@@ -349,7 +364,8 @@ module Playwright
           timeout: timeout,
         },
         value,
-        "Locator expected to have Value"
+        "Locator expected to have Value",
+        'Expect "to_have_value"',
       )
     end
     _define_negation :to_have_value
@@ -364,7 +380,8 @@ module Playwright
           timeout: timeout,
         },
         values,
-        "Locator expected to have Values"
+        "Locator expected to have Values",
+        'Expect "to_have_values"',
       )
     end
     _define_negation :to_have_values
@@ -385,7 +402,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to have text"
+          "Locator expected to have text",
+          'Expect "to_have_text"',
         )
       else
         expected_text = to_expected_text_values(
@@ -402,7 +420,8 @@ module Playwright
             timeout: timeout,
           },
           expected,
-          "Locator expected to have text"
+          "Locator expected to have text",
+          'Expect "to_have_text"',
         )
       end
     end
@@ -417,6 +436,7 @@ module Playwright
         },
         expected,
         'Locator expected to match Aria snapshot',
+        'Expect "to_match_aria_snapshot"',
       )
     end
     _define_negation :to_match_aria_snapshot
@@ -426,7 +446,8 @@ module Playwright
         (attached || attached.nil?) ? "to.be.attached" : "to.be.detached",
         { timeout: timeout },
         nil,
-        "Locator expected to be attached"
+        "Locator expected to be attached",
+        'Expect "to_be_attached"',
       )
     end
     _define_negation :to_be_attached
@@ -449,7 +470,8 @@ module Playwright
         "to.be.checked",
         { timeout: timeout, expectedValue: expected_value },
         nil,
-        "Locator expected to be checked"
+        "Locator expected to be checked",
+        'Expect "to_be_checked"',
       )
     end
     _define_negation :to_be_checked
@@ -459,7 +481,8 @@ module Playwright
         "to.be.disabled",
         { timeout: timeout },
         nil,
-        "Locator expected to be disabled"
+        "Locator expected to be disabled",
+        'Expect "to_be_disabled"',
       )
     end
     _define_negation :to_be_disabled
@@ -469,7 +492,8 @@ module Playwright
         (editable || editable.nil?) ? "to.be.editable" : "to.be.readonly",
         { timeout: timeout },
         nil,
-        "Locator expected to be editable"
+        "Locator expected to be editable",
+        'Expect "to_be_editable"',
       )
     end
     _define_negation :to_be_editable
@@ -479,7 +503,8 @@ module Playwright
         "to.be.empty",
         { timeout: timeout },
         nil,
-        "Locator expected to be empty"
+        "Locator expected to be empty",
+        'Expect "to_be_empty"',
       )
     end
     _define_negation :to_be_empty
@@ -489,7 +514,8 @@ module Playwright
         (enabled || enabled.nil?) ? "to.be.enabled" : "to.be.disabled",
         { timeout: timeout },
         nil,
-        "Locator expected to be enabled"
+        "Locator expected to be enabled",
+        'Expect "to_be_enabled"',
       )
     end
     _define_negation :to_be_enabled
@@ -499,7 +525,8 @@ module Playwright
         "to.be.hidden",
         { timeout: timeout },
         nil,
-        "Locator expected to be hidden"
+        "Locator expected to be hidden",
+        'Expect "to_be_hidden"',
       )
     end
     _define_negation :to_be_hidden
@@ -509,7 +536,8 @@ module Playwright
         (visible || visible.nil?) ? "to.be.visible" : "to.be.hidden",
         { timeout: timeout },
         nil,
-        "Locator expected to be visible"
+        "Locator expected to be visible",
+        'Expect "to_be_visible"',
       )
     end
     _define_negation :to_be_visible
@@ -519,7 +547,8 @@ module Playwright
         "to.be.focused",
         { timeout: timeout },
         nil,
-        "Locator expected to be focused"
+        "Locator expected to be focused",
+        'Expect "to_be_focused"',
       )
     end
     _define_negation :to_be_focused
@@ -529,7 +558,8 @@ module Playwright
         "to.be.in.viewport",
         { timeout: timeout, expectedNumber: ratio }.compact,
         nil,
-        "Locator expected to be in viewport"
+        "Locator expected to be in viewport",
+        'Expect "to_be_in_viewport"',
       )
     end
     _define_negation :to_be_in_viewport

data/lib/playwright/locator_impl.rb

@@ -5,9 +5,8 @@ module Playwright
   define_api_implementation :LocatorImpl do
     include LocatorUtils
 
-    def initialize(frame:, timeout_settings:, selector:, has: nil, hasNot: nil, hasNotText: nil, hasText: nil, visible: nil)
+    def initialize(frame:, selector:, has: nil, hasNot: nil, hasNotText: nil, hasText: nil, visible: nil)
       @frame = frame
-      @timeout_settings = timeout_settings
       selector_scopes = [selector]
 
       if hasText
@@ -40,7 +39,11 @@ module Playwright
     end
 
     def to_s
-      "Locator@#{@selector}"
+      if @description
+        "Locator@#{@selector} (#{@description})"
+      else
+        "Locator@#{@selector}"
+      end
     end
 
     private def to_protocol
@@ -64,8 +67,12 @@ module Playwright
       @selector.to_json
     end
 
+    private def _timeout(timeout)
+      @frame.send(:_timeout, timeout)
+    end
+
     private def with_element(timeout: nil, &block)
-      timeout_or_default = @timeout_settings.timeout(timeout)
+      timeout_or_default = _timeout(timeout)
       start_time = Time.now
 
       handle = @frame.wait_for_selector(@selector, strict: true, state: 'attached', timeout: timeout_or_default)
@@ -213,7 +220,6 @@ module Playwright
       hasText: nil)
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> #{selector}",
         has: has,
         hasNot: hasNot,
@@ -224,7 +230,6 @@ module Playwright
     def frame_locator(selector)
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: "#{@selector} >> #{selector}",
       )
     end
@@ -240,15 +245,20 @@ module Playwright
     def content_frame
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: @selector,
       )
     end
 
+    def describe(description)
+      LocatorImpl.new(
+        frame: @frame,
+        selector: "#{@selector} >> internal:describe=#{description.to_json}",
+      )
+    end
+
     def filter(has: nil, hasNot: nil, hasNotText: nil, hasText: nil, visible: nil)
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: @selector,
         has: has,
         hasNot: hasNot,
@@ -261,7 +271,6 @@ module Playwright
     def first
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> nth=0",
       )
     end
@@ -269,7 +278,6 @@ module Playwright
     def last
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> nth=-1",
       )
     end
@@ -277,7 +285,6 @@ module Playwright
     def nth(index)
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> nth=#{index}",
       )
     end
@@ -288,7 +295,6 @@ module Playwright
       end
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> internal:and=#{locator.send(:selector_json)}",
       )
     end
@@ -299,7 +305,6 @@ module Playwright
       end
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@selector} >> internal:or=#{locator.send(:selector_json)}",
       )
     end
@@ -312,7 +317,7 @@ module Playwright
       params = {
         selector: @selector,
         strict: true,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @frame.channel.send_message_to_server('blur', params)
     end
@@ -329,6 +334,12 @@ module Playwright
       @frame.get_attribute(@selector, name, strict: true, timeout: timeout)
     end
 
+    def generate_locator_string
+      with_element(timeout: nil) do |handle, _|
+        handle.channel.send_message_to_server('generateLocatorString')
+      end
+    end
+
     def hover(
           force: nil,
           modifiers: nil,
@@ -397,11 +408,10 @@ module Playwright
       end
     end
 
-    def aria_snapshot(timeout: nil, ref: nil)
+    def aria_snapshot(timeout: nil)
       @frame.channel.send_message_to_server('ariaSnapshot', {
         selector: @selector,
-        timeout: timeout,
-        ref: ref,
+        timeout: _timeout(timeout),
       }.compact)
     end
 
@@ -509,7 +519,7 @@ module Playwright
       @frame.highlight(@selector)
     end
 
-    def expect(expression, options)
+    def expect(expression, options, title)
       if options.key?(:expectedValue)
         options[:expectedValue] = JavaScript::ValueSerializer
           .new(options[:expectedValue])
@@ -517,8 +527,9 @@ module Playwright
       end
 
       result = @frame.channel.send_message_to_server_result(
-        "expect",
-        {
+        title, # title
+        "expect", # method
+        { # params
           selector: @selector,
           expression: expression,
           **options,

data/lib/playwright/page_assertions_impl.rb

@@ -11,21 +11,21 @@ module Playwright
       end
     end
 
-    def initialize(page, timeout, is_not, message)
+    def initialize(page, default_expect_timeout, is_not, message)
       @page = PlaywrightApi.unwrap(page)
       @locator = @page.locator(":root")
-      @timeout = timeout
+      @default_expect_timeout = default_expect_timeout
       @is_not = is_not
       @custom_message = message
     end
 
-    private def expect_impl(expression, expect_options, expected, message)
-      expect_options[:timeout] ||= 5000
+    private def expect_impl(expression, expect_options, expected, message, title)
+      expect_options[:timeout] ||= @default_expect_timeout
       expect_options[:isNot] = @is_not
       message.gsub!("expected to", "not expected to") if @is_not
       expect_options.delete(:useInnerText) if expect_options.key?(:useInnerText) && expect_options[:useInnerText].nil?
 
-      result = @locator.expect(expression, expect_options)
+      result = @locator.expect(expression, expect_options, title)
 
       if result["matches"] == @is_not
         actual = result["received"]
@@ -60,7 +60,7 @@ module Playwright
     private def _not # "not" is reserved in Ruby
       PageAssertionsImpl.new(
         @page,
-        @timeout,
+        @default_expect_timeout,
         !@is_not,
         @message
       )
@@ -117,7 +117,8 @@ module Playwright
           timeout: timeout,
         },
         title_or_regex,
-        "Page title expected to be"
+        "Page title expected to be",
+        'Expect "to_have_title"',
       )
     end
     _define_negation :to_have_title
@@ -141,7 +142,8 @@ module Playwright
           timeout: timeout,
         },
         expected,
-        "Page URL expected to be"
+        "Page URL expected to be",
+        'Expect "to_have_url"',
       )
     end
     _define_negation :to_have_url

data/lib/playwright/selectors_impl.rb

@@ -0,0 +1,45 @@
+module Playwright
+  # https://github.com/microsoft/playwright-python/blob/master/playwright/_impl/_selectors.py
+  define_api_implementation :SelectorsImpl do
+    def initialize
+      @selector_engines = []
+      @contexts_for_selectors = Set.new
+    end
+
+    def register(name, contentScript: nil, path: nil, script: nil)
+      source =
+        if path
+          File.read(path)
+        elsif script
+          script
+        else
+          raise ArgumentError.new('Either path or script parameter must be specified')
+        end
+      selector_engine = { name: name, source: source }
+      if contentScript
+        selector_engine[:contentScript] = true
+      end
+      @contexts_for_selectors.each do |context|
+        context.send(:register_selector_engine, selector_engine)
+      end
+      @selector_engines << selector_engine
+
+      nil
+    end
+
+    def set_test_id_attribute(attribute_name)
+      @test_id_attribute_name = attribute_name
+      ::Playwright::LocatorUtils.instance_variable_set(:@test_id_attribute_name, attribute_name)
+    end
+
+    private def update_with_selector_options(options)
+      options[:selectorEngines] = @selector_engines unless @selector_engines.empty?
+      options[:testIdAttributeName] = @test_id_attribute_name if @test_id_attribute_name
+      options
+    end
+
+    private def contexts_for_selectors
+      @contexts_for_selectors
+    end
+  end
+end

data/lib/playwright/test.rb

@@ -2,10 +2,28 @@ module Playwright
   # this module is responsible for running playwright assertions and integrating
   # with test frameworks.
   module Test
+    @@expect_timeout = nil
+
+    def self.expect_timeout
+      @@expect_timeout || 5000 # default timeout is 5000ms
+    end
+
+    def self.expect_timeout=(timeout)
+      @@expect_timeout = timeout
+    end
+
+    def self.with_timeout(expect_timeout, &block)
+      old_timeout = @@expect_timeout
+      @@expect_timeout = expect_timeout
+      block.call
+    ensure
+      @@expect_timeout = old_timeout
+    end
+
     # ref: https://github.com/microsoft/playwright-python/blob/main/playwright/sync_api/__init__.py#L90
     class Expect
       def initialize
-        @timeout_settings = TimeoutSettings.new
+        @default_expect_timeout = ::Playwright::Test.expect_timeout
       end
 
       def call(actual, is_not)
@@ -14,7 +32,7 @@ module Playwright
           PageAssertions.new(
             PageAssertionsImpl.new(
               actual,
-              @timeout_settings.timeout,
+              @default_expect_timeout,
               is_not,
               nil,
             )
@@ -23,7 +41,7 @@ module Playwright
           LocatorAssertions.new(
             LocatorAssertionsImpl.new(
               actual,
-              @timeout_settings.timeout,
+              @default_expect_timeout,
               is_not,
               nil,
             )

data/lib/playwright/timeout_settings.rb

@@ -1,6 +1,7 @@
 module Playwright
   class TimeoutSettings
     DEFAULT_TIMEOUT = 30000
+    DEFAULT_LAUNCH_TIMEOUT = 180000 # 3 minutes
 
     def initialize(parent = nil)
       @parent = parent
@@ -15,5 +16,9 @@ module Playwright
     def timeout(timeout_override = nil)
       timeout_override || @default_timeout || @parent&.timeout || DEFAULT_TIMEOUT
     end
+
+    def launch_timeout(timeout_override = nil)
+      timeout_override || @default_timeout || @parent&.launch_timeout || DEFAULT_LAUNCH_TIMEOUT
+    end
   end
 end

data/lib/playwright/utils.rb

@@ -3,36 +3,6 @@ require 'base64'
 module Playwright
   module Utils
     module PrepareBrowserContextOptions
-      private def prepare_record_har_options(params)
-        out_params = {
-          path: params.delete(:record_har_path)
-        }
-        if params[:record_har_url_filter]
-          opt = params.delete(:record_har_url_filter)
-          if opt.is_a?(Regexp)
-            regex = ::Playwright::JavaScript::Regex.new(opt)
-            out_params[:urlRegexSource] = regex.source
-            out_params[:urlRegexFlags] = regex.flag
-          elsif opt.is_a?(String)
-            out_params[:urlGlob] = opt
-          end
-        end
-        if params[:record_har_mode]
-          out_params[:mode] = params.delete(:record_har_mode)
-        end
-        if params[:record_har_content]
-          out_params[:content] = params.delete(:record_har_content)
-        end
-        if params[:record_har_omit_content]
-          old_api_omit_content = params.delete(:record_har_omit_content)
-          if old_api_omit_content
-            out_params[:content] ||= 'omit'
-          end
-        end
-
-        out_params
-      end
-
       # @see https://github.com/microsoft/playwright/blob/5a2cfdbd47ed3c3deff77bb73e5fac34241f649d/src/client/browserContext.ts#L265
       private def prepare_browser_context_options(params)
         if params[:noViewport] == 0
@@ -42,9 +12,6 @@ module Playwright
         if params[:extraHTTPHeaders]
           params[:extraHTTPHeaders] = ::Playwright::HttpHeaders.new(params[:extraHTTPHeaders]).as_serialized
         end
-        if params[:record_har_path]
-          params[:recordHar] = prepare_record_har_options(params)
-        end
         if params[:record_video_dir]
           params[:recordVideo] = {
             dir: params.delete(:record_video_dir)