playwright-ruby-client 1.51.0 → 1.56.0

data/lib/playwright/channel_owners/frame.rb

@@ -26,6 +26,14 @@ module Playwright
     attr_reader :page, :parent_frame
     attr_writer :detached
 
+    private def _timeout(timeout)
+      @page.send(:_timeout_settings).timeout(timeout)
+    end
+
+    private def _navigation_timeout(timeout)
+      @page.send(:_timeout_settings).navigation_timeout(timeout)
+    end
+
     private def on_load_state(add:, remove:)
       if add
         @load_states << add
@@ -63,7 +71,7 @@ module Playwright
     def goto(url, timeout: nil, waitUntil: nil, referer: nil)
       params = {
         url: url,
-        timeout: timeout,
+        timeout: _navigation_timeout(timeout),
         waitUntil: waitUntil,
         referer: referer
       }.compact
@@ -94,7 +102,7 @@ module Playwright
 
     def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
       option_wait_until = waitUntil || 'load'
-      option_timeout = timeout || @page.send(:timeout_settings).navigation_timeout
+      option_timeout = _navigation_timeout(timeout)
       time_start = Time.now
 
       waiter = setup_navigation_waiter(wait_name: :expect_navigation, timeout_value: option_timeout)
@@ -148,7 +156,7 @@ module Playwright
 
     def wait_for_load_state(state: nil, timeout: nil)
       option_state = state || 'load'
-      option_timeout = timeout || @page.send(:timeout_settings).navigation_timeout
+      option_timeout = _navigation_timeout(timeout)
       unless %w(load domcontentloaded networkidle commit).include?(option_state)
         raise ArgumentError.new('state: expected one of (load|domcontentloaded|networkidle|commit)')
       end
@@ -204,39 +212,39 @@ module Playwright
     end
 
     def wait_for_selector(selector, state: nil, strict: nil, timeout: nil)
-      params = { selector: selector, state: state, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, state: state, strict: strict, timeout: _timeout(timeout) }.compact
       resp = @channel.send_message_to_server('waitForSelector', params)
 
       ChannelOwners::ElementHandle.from_nullable(resp)
     end
 
     def checked?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isChecked', params)
     end
 
     def disabled?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isDisabled', params)
     end
 
     def editable?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isEditable', params)
     end
 
     def enabled?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isEnabled', params)
     end
 
     def hidden?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isHidden', params)
     end
 
     def visible?(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('isVisible', params)
     end
 
@@ -246,7 +254,7 @@ module Playwright
         type: type,
         eventInit: JavaScript::ValueSerializer.new(eventInit).serialize,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @channel.send_message_to_server('dispatchEvent', params)
 
@@ -268,7 +276,7 @@ module Playwright
     def set_content(html, timeout: nil, waitUntil: nil)
       params = {
         html: html,
-        timeout: timeout,
+        timeout: _navigation_timeout(timeout),
         waitUntil: waitUntil,
       }.compact
 
@@ -341,7 +349,7 @@ module Playwright
         noWaitAfter: noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('click', params)
@@ -368,7 +376,7 @@ module Playwright
         sourcePosition: sourcePosition,
         strict: strict,
         targetPosition: targetPosition,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('dragAndDrop', params)
@@ -397,7 +405,7 @@ module Playwright
         noWaitAfter: noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('dblclick', params)
@@ -421,7 +429,7 @@ module Playwright
         noWaitAfter: noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('tap', params)
@@ -442,7 +450,7 @@ module Playwright
         force: force,
         noWaitAfter: noWaitAfter,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @channel.send_message_to_server('fill', params)
 
@@ -457,7 +465,6 @@ module Playwright
       hasText: nil)
       LocatorImpl.new(
         frame: self,
-        timeout_settings: @page.send(:timeout_settings),
         selector: selector,
         has: has,
         hasNot: hasNot,
@@ -466,27 +473,27 @@ module Playwright
     end
 
     def frame_locator(selector)
-      FrameLocatorImpl.new(frame: self, timeout_settings: @page.send(:timeout_settings), frame_selector: selector)
+      FrameLocatorImpl.new(frame: self, frame_selector: selector)
     end
 
     def focus(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('focus', params)
       nil
     end
 
     def text_content(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('textContent', params)
     end
 
     def inner_text(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('innerText', params)
     end
 
     def inner_html(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('innerHTML', params)
     end
 
@@ -495,7 +502,7 @@ module Playwright
         selector: selector,
         name: name,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @channel.send_message_to_server('getAttribute', params)
     end
@@ -516,7 +523,7 @@ module Playwright
         noWaitAfter: noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('hover', params)
@@ -540,12 +547,12 @@ module Playwright
         value: value,
         label: label,
       ).as_params
-      params = base_params.merge({ selector: selector, force: force, noWaitAfter: noWaitAfter, strict: strict, timeout: timeout }.compact)
+      params = base_params.merge({ selector: selector, force: force, noWaitAfter: noWaitAfter, strict: strict, timeout: _timeout(timeout) }.compact)
       @channel.send_message_to_server('selectOption', params)
     end
 
     def input_value(selector, strict: nil, timeout: nil)
-      params = { selector: selector, strict: strict, timeout: timeout }.compact
+      params = { selector: selector, strict: strict, timeout: _timeout(timeout) }.compact
       @channel.send_message_to_server('inputValue', params)
     end
 
@@ -555,7 +562,7 @@ module Playwright
         selector: selector,
         noWaitAfter: noWaitAfter,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact)
       @channel.send_message_to_server(method_name, params)
 
@@ -576,7 +583,7 @@ module Playwright
         delay: delay,
         noWaitAfter: noWaitAfter,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @channel.send_message_to_server('type', params)
 
@@ -597,7 +604,7 @@ module Playwright
         delay: delay,
         noWaitAfter: noWaitAfter,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
       }.compact
       @channel.send_message_to_server('press', params)
 
@@ -619,7 +626,7 @@ module Playwright
         noWaitAfter:  noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('check', params)
@@ -642,7 +649,7 @@ module Playwright
         noWaitAfter:  noWaitAfter,
         position: position,
         strict: strict,
-        timeout: timeout,
+        timeout: _timeout(timeout),
         trial: trial,
       }.compact
       @channel.send_message_to_server('uncheck', params)
@@ -659,7 +666,7 @@ module Playwright
     end
 
     def wait_for_timeout(timeout)
-      @channel.send_message_to_server('waitForTimeout', timeout: timeout)
+      @channel.send_message_to_server('waitForTimeout', waitTimeout: timeout)
 
       nil
     end
@@ -670,7 +677,7 @@ module Playwright
       end
 
       expression = JavaScript::Expression.new(pageFunction, arg)
-      expression.wait_for_function(@channel, polling: polling, timeout: timeout)
+      expression.wait_for_function(@channel, polling: polling, timeout: _timeout(timeout))
     end
 
     def title
@@ -681,6 +688,30 @@ module Playwright
       @channel.send_message_to_server('highlight', selector: selector)
     end
 
+    def expect(selector, expression, options, title)
+      if options.key?(:expectedValue)
+        options[:expectedValue] = JavaScript::ValueSerializer
+          .new(options[:expectedValue])
+          .serialize
+      end
+
+      result = @channel.send_message_to_server_result(
+        title, # title
+        "expect", # method
+        { # params
+          selector: selector,
+          expression: expression,
+          **options,
+        }.compact
+      )
+
+      if result.key?('received')
+        result['received'] = JavaScript::ValueParser.new(result['received']).parse
+      end
+
+      result
+    end
+
     # @param page [Page]
     # @note This method should be used internally. Accessed via .send method, so keep private!
     private def update_page_from_page(page)

data/lib/playwright/channel_owners/page.rb

@@ -42,6 +42,7 @@ module Playwright
       @channel.on('fileChooser', ->(params) {
         chooser = FileChooserImpl.new(
                     page: self,
+                    timeout_settings: @timeout_settings,
                     element_handle: ChannelOwners::ElementHandle.from(params['element']),
                     is_multiple: params['isMultiple'])
         emit(Events::Page::FileChooser, chooser)
@@ -57,6 +58,7 @@ module Playwright
       })
       @channel.on('route', ->(params) { on_route(ChannelOwners::Route.from(params['route'])) })
       @channel.on('video', method(:on_video))
+      @channel.on('viewportSizeChanged', method(:on_viewport_size_changed))
       @channel.on('webSocket', ->(params) {
         emit(Events::Page::WebSocket, ChannelOwners::WebSocket.from(params['webSocket']))
       })
@@ -147,7 +149,6 @@ module Playwright
     private def on_close
       @closed = true
       @browser_context.send(:remove_page, self)
-      @browser_context.send(:remove_background_page, self)
       if @closed_or_crashed_promise.pending?
         @closed_or_crashed_promise.fulfill(close_error_with_reason)
       end
@@ -177,6 +178,13 @@ module Playwright
       video.send(:set_artifact, artifact)
     end
 
+    private def on_viewport_size_changed(params)
+      @viewport_size = {
+        width: params['viewportSize']['width'],
+        height: params['viewportSize']['height'],
+      }
+    end
+
     # @override
     private def perform_event_emitter_callback(event, callback, args)
       should_callback_async = [
@@ -230,12 +238,10 @@ module Playwright
 
     def set_default_navigation_timeout(timeout)
       @timeout_settings.default_navigation_timeout = timeout
-      @channel.send_message_to_server('setDefaultNavigationTimeoutNoReply', timeout: timeout)
     end
 
     def set_default_timeout(timeout)
       @timeout_settings.default_timeout = timeout
-      @channel.send_message_to_server('setDefaultTimeoutNoReply', timeout: timeout)
     end
 
     def query_selector(selector, strict: nil)
@@ -339,7 +345,7 @@ module Playwright
 
     def reload(timeout: nil, waitUntil: nil)
       params = {
-        timeout: timeout,
+        timeout: @timeout_settings.timeout(timeout),
         waitUntil: waitUntil,
       }.compact
       resp = @channel.send_message_to_server('reload', params)
@@ -355,13 +361,13 @@ module Playwright
     end
 
     def go_back(timeout: nil, waitUntil: nil)
-      params = { timeout: timeout, waitUntil: waitUntil }.compact
+      params = { timeout: @timeout_settings.timeout(timeout), waitUntil: waitUntil }.compact
       resp = @channel.send_message_to_server('goBack', params)
       ChannelOwners::Response.from_nullable(resp)
     end
 
     def go_forward(timeout: nil, waitUntil: nil)
-      params = { timeout: timeout, waitUntil: waitUntil }.compact
+      params = { timeout: @timeout_settings.timeout(timeout), waitUntil: waitUntil }.compact
       resp = @channel.send_message_to_server('goForward', params)
       ChannelOwners::Response.from_nullable(resp)
     end
@@ -432,7 +438,7 @@ module Playwright
 
     def route_from_har(har, notFound: nil, update: nil, url: nil, updateContent: nil, updateMode: nil)
       if update
-        @browser_context.send(:record_into_har, har, self, notFound: notFound, url: url, updateContent: updateContent, updateMode: updateMode)
+        @browser_context.send(:record_into_har, har, self, url: url, update_content: updateContent, update_mode: updateMode)
         return
       end
 
@@ -481,7 +487,7 @@ module Playwright
         caret: caret,
         scale: scale,
         style: style,
-        timeout: timeout,
+        timeout: @timeout_settings.timeout(timeout),
       }.compact
       if mask.is_a?(Enumerable)
         params[:mask] = mask.map do |locator|
@@ -632,6 +638,20 @@ module Playwright
         timeout: timeout)
     end
 
+    def console_messages
+      messages = @channel.send_message_to_server('consoleMessages')
+      messages.map do |message|
+        ConsoleMessageImpl.new(message, self)
+      end
+    end
+
+    def page_errors
+      errors = @channel.send_message_to_server('pageErrors')
+      errors.map do |error|
+        Error.parse(error['error'])
+      end
+    end
+
     def locator(
       selector,
       has: nil,
@@ -819,6 +839,12 @@ module Playwright
       @workers.to_a
     end
 
+    def requests
+      @channel.send_message_to_server('requests').map do |req|
+        ChannelOwners::Request.from(req)
+      end
+    end
+
     def request
       @browser_context.request
     end
@@ -875,6 +901,10 @@ module Playwright
       @video ||= Video.new(self)
     end
 
+    def snapshot_for_ai(timeout: nil)
+      @channel.send_message_to_server('snapshotForAI', timeout: @timeout_settings.timeout(timeout))
+    end
+
     def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
       params = {
         resetOnNavigation: resetOnNavigation,
@@ -1003,7 +1033,7 @@ module Playwright
     end
 
     # called from Frame with send(:timeout_settings)
-    private def timeout_settings
+    private def _timeout_settings
       @timeout_settings
     end
 

data/lib/playwright/channel_owners/playwright.rb

@@ -1,15 +1,21 @@
 module Playwright
   define_channel_owner :Playwright do
     def chromium
-      @chromium ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['chromium'])
+      @chromium ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['chromium']).tap do |browser_type|
+        browser_type.send(:update_playwright, self)
+      end
     end
 
     def firefox
-      @firefox ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['firefox'])
+      @firefox ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['firefox']).tap do |browser_type|
+        browser_type.send(:update_playwright, self)
+      end
     end
 
     def webkit
-      @webkit ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['webkit'])
+      @webkit ||= ::Playwright::ChannelOwners::BrowserType.from(@initializer['webkit']).tap do |browser_type|
+        browser_type.send(:update_playwright, self)
+      end
     end
 
     def android
@@ -21,7 +27,7 @@ module Playwright
     end
 
     def selectors
-      @selectors ||= ::Playwright::ChannelOwners::Selectors.from(@initializer['selectors'])
+      @selectors ||= ::Playwright::SelectorsImpl.new
     end
 
     def devices

data/lib/playwright/channel_owners/web_socket.rb

@@ -35,7 +35,7 @@ module Playwright
 
     def expect_event(event, predicate: nil, timeout: nil, &block)
       waiter = Waiter.new(self, wait_name: "WebSocket.expect_event(#{event})")
-      timeout_value = timeout || @parent.send(:timeout_settings).timeout
+      timeout_value = timeout || @parent.send(:_timeout_settings).timeout
       waiter.reject_on_timeout(timeout_value, "Timeout #{timeout_value}ms exceeded while waiting for event \"#{event}\"")
 
       unless event == Events::WebSocket::Close

data/lib/playwright/connection.rb

@@ -90,6 +90,9 @@ module Playwright
           _metadata[:apiName] = metadata[:apiName]
           _metadata[:location] = metadata[:stack].first
           _metadata[:internal] = !metadata[:apiName]
+          if metadata[:title]
+            _metadata[:title] = metadata[:title]
+          end
         end
         _metadata.compact!
 

data/lib/playwright/console_message_impl.rb

@@ -1,11 +1,12 @@
 module Playwright
   define_api_implementation :ConsoleMessageImpl do
-    def initialize(event)
+    def initialize(event, page)
       @event = event
+      @page = page
     end
 
     def page
-      @page ||= ChannelOwners::Page.from_nullable(@event['page'])
+      @page
     end
 
     def type

data/lib/playwright/file_chooser_impl.rb

@@ -1,7 +1,8 @@
 module Playwright
   define_api_implementation :FileChooserImpl do
-    def initialize(page:, element_handle:, is_multiple:)
+    def initialize(page:, timeout_settings:, element_handle:, is_multiple:)
       @page = page
+      @timeout_settings = timeout_settings
       @element_handle = element_handle
       @is_multiple = is_multiple
     end
@@ -17,7 +18,7 @@ module Playwright
     end
 
     def set_files(files, noWaitAfter: nil, timeout: nil)
-      @element_handle.set_input_files(files, noWaitAfter: noWaitAfter, timeout: timeout)
+      @element_handle.set_input_files(files, noWaitAfter: noWaitAfter, timeout: @timeout_settings.timeout(timeout))
     end
   end
 end

data/lib/playwright/frame_locator_impl.rb

@@ -4,12 +4,15 @@ module Playwright
   define_api_implementation :FrameLocatorImpl do
     include LocatorUtils
 
-    def initialize(frame:, timeout_settings:, frame_selector:)
+    def initialize(frame:, frame_selector:)
       @frame = frame
-      @timeout_settings = timeout_settings
       @frame_selector = frame_selector
     end
 
+    private def _timeout(timeout)
+      @frame.send(:_timeout, timeout)
+    end
+
     def locator(
       selector,
       has: nil,
@@ -18,7 +21,6 @@ module Playwright
       hasText: nil)
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: "#{@frame_selector} >> internal:control=enter-frame >> #{selector}",
         has: has,
         hasNot: hasNot,
@@ -29,7 +31,6 @@ module Playwright
     def owner
       LocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         selector: @frame_selector,
       )
     end
@@ -37,7 +38,6 @@ module Playwright
     def frame_locator(selector)
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: "#{@frame_selector} >> internal:control=enter-frame >> #{selector}",
       )
     end
@@ -45,7 +45,6 @@ module Playwright
     def first
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: "#{@frame_selector} >> nth=0",
       )
     end
@@ -53,7 +52,6 @@ module Playwright
     def last
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: "#{@frame_selector} >> nth=-1",
       )
     end
@@ -61,7 +59,6 @@ module Playwright
     def nth(index)
       FrameLocatorImpl.new(
         frame: @frame,
-        timeout_settings: @timeout_settings,
         frame_selector: "#{@frame_selector} >> nth=#{index}",
       )
     end

data/lib/playwright/javascript/value_parser.rb

@@ -1,4 +1,5 @@
-require 'date'
+require 'base64'
+require 'time'
 
 module Playwright
   module JavaScript
@@ -45,7 +46,7 @@ module Playwright
         end
 
         if hash.key?('d')
-          return DateTime.parse(hash['d'])
+          return Time.parse(hash['d'])
         end
 
         if hash.key?('u')
@@ -105,6 +106,57 @@ module Playwright
           return @handles[hash['h']]
         end
 
+        if hash.key?('ta')
+          encoded_bytes = hash['ta']['b']
+          decoded_bytes = Base64.strict_decode64(encoded_bytes)
+          array_type = hash['ta']['k']
+
+          if array_type == 'i8'
+            word_size = 1
+            unpack_format = 'c*' # signed char
+          elsif array_type == 'ui8' || array_type == 'ui8c'
+            word_size = 1
+            unpack_format = 'C*' # unsigned char
+          elsif array_type == 'i16'
+            word_size = 2
+            unpack_format = 's<*' # signed short, little-endian
+          elsif array_type == 'ui16'
+            word_size = 2
+            unpack_format = 'S<*' # unsigned short, little-endian
+          elsif array_type == 'i32'
+            word_size = 4
+            unpack_format = 'l<*' # signed long, little-endian
+          elsif array_type == 'ui32'
+            word_size = 4
+            unpack_format = 'L<*' # unsigned long, little-endian
+          elsif array_type == 'f32'
+            word_size = 4
+            unpack_format = 'e*' # float, little-endian
+          elsif array_type == 'f64'
+            word_size = 8
+            unpack_format = 'E*' # double, little-endian
+          elsif array_type == 'bi64'
+            word_size = 8
+            unpack_format = 'q<*' # signed long long, little-endian
+          elsif array_type == 'bui64'
+            word_size = 8
+            unpack_format = 'Q<*' # unsigned long long, little-endian
+          else
+            raise ArgumentError, "Unsupported array type: #{array_type}"
+          end
+
+          byte_len = decoded_bytes.bytesize
+          if byte_len.zero?
+            return []
+          end
+
+          if byte_len % word_size != 0
+            raise ArgumentError, "Decoded bytes length #{byte_len} is not a multiple of word size #{word_size} for type #{array_type}"
+          end
+
+          return decoded_bytes.unpack(unpack_format)
+        end
+
         raise ArgumentError.new("Unexpected value: #{hash}")
       end
     end