playwright-ruby-client 1.63.0 → 1.64.0

data/lib/playwright/locator_impl.rb

@@ -5,8 +5,9 @@ module Playwright
   define_api_implementation :LocatorImpl do
     include LocatorUtils
 
-    def initialize(frame:, 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, locator_code: nil)
       @frame = frame
+      @locator_code = locator_code
       selector_scopes = [selector]
 
       if hasText
@@ -39,11 +40,18 @@ module Playwright
     end
 
     def to_s
-      if @description
-        "Locator@#{@selector} (#{@description})"
-      else
-        "Locator@#{@selector}"
-      end
+      custom_description = description
+      return custom_description if custom_description
+      return @locator_code if @locator_code
+
+      local_utils = @frame.instance_variable_get(:@connection).local_utils
+      return "Locator@#{@selector}" unless local_utils
+
+      local_utils.as_locator_description(@selector)
+    end
+
+    def within(locator)
+      locator.locator(self)
     end
 
     private def to_protocol
@@ -232,6 +240,11 @@ module Playwright
       hasNot: nil,
       hasNotText: nil,
       hasText: nil)
+      if selector.is_a?(LocatorImpl)
+        raise ArgumentError, 'Locators must belong to the same frame.' unless same_frame?(selector)
+
+        selector = "internal:chain=#{selector.send(:selector_json)}"
+      end
       LocatorImpl.new(
         frame: @frame,
         selector: "#{@selector} >> #{selector}",
@@ -453,10 +466,11 @@ module Playwright
     end
 
     def normalize
-      resolved_selector = @frame.channel.send_message_to_server('resolveSelector', { selector: @selector })
+      result = @frame.channel.send_message_to_server_result('resolveSelector', { selector: @selector, sdkLanguage: 'python' })
       LocatorImpl.new(
         frame: @frame,
-        selector: resolved_selector,
+        selector: result['resolvedSelector'],
+        locator_code: result['locatorCode'],
       )
     end
 

data/lib/playwright/screencast.rb

@@ -11,7 +11,7 @@ module Playwright
       @page.send(:channel).on('screencastFrame', method(:handle_screencast_frame))
     end
 
-    def start(path: nil, size: nil, quality: nil, &on_frame)
+    def start(path: nil, size: nil, quality: nil, fps: nil, &on_frame)
       raise 'Screencast is already started' if @started
 
       @started = true
@@ -21,6 +21,7 @@ module Playwright
       params[:record] = true if path
       params[:size] = size if size
       params[:quality] = quality if quality
+      params[:fps] = fps unless fps.nil?
       params[:sendFrames] = true if on_frame
 
       result = @page.send(:channel).send_message_to_server_result('screencastStart', params)
@@ -63,12 +64,13 @@ module Playwright
       @page.send(:channel).send_message_to_server('screencastChapter', params)
     end
 
-    def show_actions(duration: nil, fontSize: nil, position: nil, cursor: nil)
+    def show_actions(duration: nil, fontSize: nil, position: nil, cursor: nil, style: nil)
       params = {}
       params[:duration] = duration if duration
       params[:fontSize] = fontSize if fontSize
       params[:position] = position if position
       params[:cursor] = cursor if cursor
+      params[:style] = style if style
       @page.send(:channel).send_message_to_server('screencastShowActions', params)
       DisposableStub.new { hide_actions }
     end

data/lib/playwright/transport.rb

@@ -32,10 +32,15 @@ module Playwright
     def send_message(message)
       debug_send_message(message) if @debug
       msg = JSON.dump(message)
-      @mutex.synchronize {
-        @stdin.write([msg.bytes.length].pack('V')) # unsigned 32bit, little endian, real byte size instead of chars
-        @stdin.write(msg) # write UTF-8 in binary mode as byte stream
-      }
+      # Build the whole frame (4-byte little-endian length header + JSON payload) in a
+      # single buffer, and write it at once. Two separate writes can be torn by an
+      # asynchronous exception (e.g. Timeout::Error from Timeout.timeout, delivered via
+      # Thread#raise), which crashes the driver with a JSON parse error.
+      # ref: https://github.com/YusukeIwaki/playwright-ruby-client/issues/392
+      frame = [msg.bytesize].pack('V') + msg.b # unsigned 32bit, little endian, real byte size instead of chars
+      Thread.handle_interrupt(Object => :never) do
+        @mutex.synchronize { @stdin.write(frame) } # write UTF-8 in binary mode as byte stream
+      end
     rescue Errno::EPIPE, IOError
       raise AlreadyDisconnectedError.new('send_message failed')
     end
@@ -85,6 +90,10 @@ module Playwright
         debug_recv_message(obj) if @debug
         @on_message&.call(obj)
       end
+      # exited the loop on clean EOF. The driver is gone, so reject pending
+      # callbacks instead of hanging forever on promises that will never resolve.
+      # ref: https://github.com/YusukeIwaki/playwright-ruby-client/issues/392
+      @on_driver_closed&.call
     rescue IOError
       # disconnected by remote.
       @on_driver_closed&.call
@@ -92,6 +101,9 @@ module Playwright
 
     def handle_stderr
       while err = @stderr.read
+        # IO#read without length on a pipe returns "" (not nil) at EOF.
+        # Bail out instead of spinning forever on empty reads.
+        break if err.empty?
         # sometimed driver crashes with the error below.
         # --------
         # undefined:1
@@ -103,7 +115,11 @@ module Playwright
         #     at Transport.transport.onmessage (/home/runner/work/playwright-ruby-client/playwright-ruby-client/node_modules/playwright/lib/cli/driver.js:42:73)
         #     at Immediate.<anonymous> (/home/runner/work/playwright-ruby-client/playwright-ruby-client/node_modules/playwright/lib/protocol/transport.js:74:26)
         #     at processImmediate (internal/timers.js:461:21)
-        if err.include?('undefined:1')
+        #
+        # Node >= 16 prints '<anonymous_script>:1' instead of 'undefined:1'.
+        # ref: https://github.com/YusukeIwaki/playwright-ruby-client/issues/392
+        if err.include?('undefined:1') || err.include?('<anonymous_script>:1') ||
+            err.include?('is not valid JSON')
           @on_driver_crashed&.call
           break
         end

data/lib/playwright/utils.rb

@@ -18,6 +18,23 @@ module Playwright
   end
 
   module Utils
+    module ClearCookiesParameters
+      private def clear_cookies_params(domain:, name:, path:)
+        params = {}
+        { domain: domain, name: name, path: path }.each do |key, value|
+          case value
+          when String
+            params[key] = value
+          when Regexp
+            regex = JavaScript::Regex.new(value)
+            params["#{key}RegexSource".to_sym] = regex.source
+            params["#{key}RegexFlags".to_sym] = regex.flag
+          end
+        end
+        params
+      end
+    end
+
     module PrepareHttpCredentials
       private def prepare_http_credentials(credentials)
         return nil unless credentials
@@ -47,6 +64,9 @@ module Playwright
           if params[:record_video_size]
             params[:recordVideo][:size] = params.delete(:record_video_size)
           end
+          unless params[:record_video_fps].nil?
+            params[:recordVideo][:fps] = params.delete(:record_video_fps)
+          end
           if params[:record_video_show_actions]
             params[:recordVideo][:showActions] = params.delete(:record_video_show_actions)
           end

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.63.0'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.63.0'
+  VERSION = '1.64.0'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.64.0'
 end

data/lib/playwright/web_mcp_impl.rb

@@ -0,0 +1,21 @@
+module Playwright
+  # https://github.com/microsoft/playwright/blob/v1.64.0/packages/playwright-core/src/client/webmcp.ts
+  define_api_implementation :WebMCPImpl do
+    def initialize(frame)
+      @frame = frame
+    end
+
+    def tools(timeout: nil)
+      @frame.channel.send_message_to_server('webmcpTools', timeout: @frame.send(:_timeout, timeout))
+    end
+
+    def call_tool(name, input: nil, timeout: nil)
+      result = @frame.channel.send_message_to_server('webmcpCallTool',
+        name: name,
+        input: JavaScript::ValueSerializer.new(input).serialize,
+        timeout: @frame.send(:_timeout, timeout),
+      )
+      JavaScript::ValueParser.new(result).parse
+    end
+  end
+end

data/lib/playwright_api/api_request_context.rb

@@ -73,6 +73,44 @@ module Playwright
       wrap_impl(@impl.tracing)
     end
 
+    #
+    # Adds cookies into this request context. They will be sent with matching subsequent requests. For [`property: BrowserContext.request`]
+    # and [`property: Page.request`], this is equivalent to calling [`method: BrowserContext.addCookies`] on the corresponding browser context.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # request.add_cookies([cookie_object1, cookie_object2])
+    # ```
+    def add_cookies(cookies)
+      wrap_impl(@impl.add_cookies(unwrap_impl(cookies)))
+    end
+
+    #
+    # Removes cookies from this request context. Accepts optional filter. For [`property: BrowserContext.request`]
+    # and [`property: Page.request`], this is equivalent to calling [`method: BrowserContext.clearCookies`] on the corresponding browser context.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # request.clear_cookies()
+    # request.clear_cookies(name="session-id")
+    # request.clear_cookies(domain="my-origin.com")
+    # request.clear_cookies(path="/api/v1")
+    # request.clear_cookies(name="session-id", domain="my-origin.com")
+    # ```
+    def clear_cookies(domain: nil, name: nil, path: nil)
+      wrap_impl(@impl.clear_cookies(domain: unwrap_impl(domain), name: unwrap_impl(name), path: unwrap_impl(path)))
+    end
+
+    #
+    # If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
+    # are returned. For [`property: BrowserContext.request`] and [`property: Page.request`], this is equivalent to calling
+    # [`method: BrowserContext.cookies`] on the corresponding browser context.
+    def cookies(urls: nil)
+      wrap_impl(@impl.cookies(urls: unwrap_impl(urls)))
+    end
+
     #
     # Sends HTTP(S) [DELETE](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/DELETE) request and returns its response.
     # The method will populate request cookies from the context and update

data/lib/playwright_api/browser.rb

@@ -113,6 +113,7 @@ module Playwright
           record_har_path: nil,
           record_har_url_filter: nil,
           record_video_dir: nil,
+          record_video_fps: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
@@ -123,7 +124,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_fps: unwrap_impl(record_video_fps), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     #
@@ -159,6 +160,7 @@ module Playwright
           record_har_path: nil,
           record_har_url_filter: nil,
           record_video_dir: nil,
+          record_video_fps: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
@@ -169,7 +171,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_fps: unwrap_impl(record_video_fps), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     #

data/lib/playwright_api/browser_context.rb

@@ -504,13 +504,13 @@ module Playwright
     end
 
     # @nodoc
-    def browser=(req)
-      wrap_impl(@impl.browser=(unwrap_impl(req)))
+    def options=(req)
+      wrap_impl(@impl.options=(unwrap_impl(req)))
     end
 
     # @nodoc
-    def options=(req)
-      wrap_impl(@impl.options=(unwrap_impl(req)))
+    def browser=(req)
+      wrap_impl(@impl.browser=(unwrap_impl(req)))
     end
 
     # @nodoc

data/lib/playwright_api/browser_type.rb

@@ -165,6 +165,7 @@ module Playwright
           record_har_path: nil,
           record_har_url_filter: nil,
           record_video_dir: nil,
+          record_video_fps: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
@@ -177,7 +178,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), artifactsDir: unwrap_impl(artifactsDir), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), slowMo: unwrap_impl(slowMo), strictSelectors: unwrap_impl(strictSelectors), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), artifactsDir: unwrap_impl(artifactsDir), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), clientCertificates: unwrap_impl(clientCertificates), colorScheme: unwrap_impl(colorScheme), contrast: unwrap_impl(contrast), deviceScaleFactor: unwrap_impl(deviceScaleFactor), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_fps: unwrap_impl(record_video_fps), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), slowMo: unwrap_impl(slowMo), strictSelectors: unwrap_impl(strictSelectors), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     #

data/lib/playwright_api/clock.rb

@@ -23,6 +23,7 @@ module Playwright
     #
     # Install fake implementations for the following time-related functions:
     # - `Date`
+    # - `Temporal.Now`
     # - `setTimeout`
     # - `clearTimeout`
     # - `setInterval`

data/lib/playwright_api/credentials.rb

@@ -54,6 +54,7 @@ module Playwright
   #     user_handle=credential["userHandle"],
   #     private_key=credential["privateKey"],
   #     public_key=credential["publicKey"],
+  #     sign_count=credential["signCount"],
   # )
   # context.credentials.install()
   #
@@ -64,7 +65,7 @@ module Playwright
   #
   # **Usage: save credentials in the storage state, restore later**
   #
-  # See [authentication guide](../auth.md) for examples of using saving and resotring the storage state.
+  # See [authentication guide](../auth.md) for examples of using saving and restoring the storage state.
   #
   # **Defaults**
   class Credentials < PlaywrightApi
@@ -90,7 +91,8 @@ module Playwright
     # username-then-passkey and usernameless passkey flows. The returned object carries the private and public keys, so it can be persisted to disk and re-seeded in a later test.
     #
     # To **import a known credential**, supply all four of `id`, `userHandle`, `privateKey` and
-    # `publicKey` together.
+    # `publicKey` together. Pass `signCount` as well to continue from the
+    # signature counter the relying party has already seen.
     #
     # Call [`method: Credentials.install`] before navigating to a page that uses WebAuthn.
     def create(
@@ -98,8 +100,9 @@ module Playwright
           id: nil,
           privateKey: nil,
           publicKey: nil,
+          signCount: nil,
           userHandle: nil)
-      wrap_impl(@impl.create(unwrap_impl(rpId), id: unwrap_impl(id), privateKey: unwrap_impl(privateKey), publicKey: unwrap_impl(publicKey), userHandle: unwrap_impl(userHandle)))
+      wrap_impl(@impl.create(unwrap_impl(rpId), id: unwrap_impl(id), privateKey: unwrap_impl(privateKey), publicKey: unwrap_impl(publicKey), signCount: unwrap_impl(signCount), userHandle: unwrap_impl(userHandle)))
     end
 
     #
@@ -115,7 +118,7 @@ module Playwright
     # `id`. This includes both credentials seeded with [`method: Credentials.create`] and credentials
     # the page registered itself by calling `navigator.credentials.create()`.
     #
-    # Each returned credential includes its private and public keys, so a passkey the app just
+    # Each returned credential includes its private and public keys and the current signature counter, so a passkey the app just
     # registered can be saved and re-seeded into a later test with [`method: Credentials.create`] — see the second example in the class overview.
     def get(id: nil, rpId: nil)
       wrap_impl(@impl.get(id: unwrap_impl(id), rpId: unwrap_impl(rpId)))

data/lib/playwright_api/frame.rb

@@ -31,6 +31,12 @@ module Playwright
   # ```
   class Frame < PlaywrightApi
 
+    #
+    # Tools that the frame registers through the experimental `WebMCP` browser API. See `WebMCP` for details.
+    def webmcp # property
+      wrap_impl(@impl.webmcp)
+    end
+
     #
     # Returns the added tag when the script's onload fires or when the script content was injected into frame.
     #
@@ -103,8 +109,8 @@ module Playwright
 
     #
     # Gets the full HTML contents of the frame, including the doctype.
-    def content
-      wrap_impl(@impl.content)
+    def content(includeShadow: nil)
+      wrap_impl(@impl.content(includeShadow: unwrap_impl(includeShadow)))
     end
 
     #

data/lib/playwright_api/locator.rb

@@ -961,6 +961,26 @@ module Playwright
     #
     # Returns a new locator that uses best practices for referencing the matched element, prioritizing test ids,
     # aria roles, and other user-facing attributes over CSS selectors. This is useful for converting implementation-detail selectors into more resilient, human-readable locators.
+    #
+    # **Usage**
+    #
+    # An agent can pick an element by its ref from an [`method: Page.ariaSnapshot`] taken in the `"ai"` mode. Refs only
+    # work for the latest snapshot. Normalize the ref locator and convert it to a string to get resilient locator code
+    # in your language, the same way `codegen` does.
+    #
+    # Consider the following aria snapshot.
+    #
+    # ```yaml
+    # - button "Submit" [ref=e2]
+    # ```
+    #
+    # You can turn the ref into locator code:
+    #
+    # ```python sync
+    # normalized = page.get_by_ref("e2").normalize()
+    # print(str(normalized))
+    # # get_by_role("button", name="Submit")
+    # ```
     def normalize
       wrap_impl(@impl.normalize)
     end
@@ -1376,9 +1396,19 @@ module Playwright
       wrap_impl(@impl.wait_for_function(unwrap_impl(expression), arg: unwrap_impl(arg), timeout: unwrap_impl(timeout)))
     end
 
-    # @nodoc
-    def expect(expression, options, title)
-      wrap_impl(@impl.expect(unwrap_impl(expression), unwrap_impl(options), unwrap_impl(title)))
+    #
+    # Returns a locator that matches this locator's elements inside each element matched by `locator`.
+    #
+    # Note that relative locators, such as [`method: Locator.nth`] or [`method: Locator.first`], are resolved separately inside each matched parent. In the example below, `page.getByRole('cell').nth(2)` picks the third cell of every row, not the third cell in the whole table.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # third_column = page.get_by_role("cell").nth(2).within(page.get_by_role("row"))
+    # expect(third_column).to_have_text(["Apple", "Banana", "Cherry"])
+    # ```
+    def within(locator)
+      wrap_impl(@impl.within(unwrap_impl(locator)))
     end
 
     # @nodoc
@@ -1391,6 +1421,11 @@ module Playwright
       wrap_impl(@impl.resolve_selector)
     end
 
+    # @nodoc
+    def expect(expression, options, title)
+      wrap_impl(@impl.expect(unwrap_impl(expression), unwrap_impl(options), unwrap_impl(title)))
+    end
+
     # @nodoc
     def to_s
       wrap_impl(@impl.to_s)

data/lib/playwright_api/page.rb

@@ -88,6 +88,14 @@ module Playwright
       wrap_impl(@impl.touchscreen)
     end
 
+    #
+    # Tools that the main frame registers through the experimental `WebMCP` browser API. Shortcut for [`property: Frame.webmcp`] of [`method: Page.mainFrame`], see `WebMCP` for details.
+    #
+    # **Usage**
+    def webmcp # property
+      wrap_impl(@impl.webmcp)
+    end
+
     #
     # Adds a script which would be evaluated in one of the following scenarios:
     # - Whenever the page is navigated.
@@ -201,8 +209,8 @@ module Playwright
 
     #
     # Gets the full HTML contents of the page, including the doctype.
-    def content
-      wrap_impl(@impl.content)
+    def content(includeShadow: nil)
+      wrap_impl(@impl.content(includeShadow: unwrap_impl(includeShadow)))
     end
 
     #
@@ -687,6 +695,27 @@ module Playwright
       wrap_impl(@impl.get_by_placeholder(unwrap_impl(text), exact: unwrap_impl(exact)))
     end
 
+    #
+    # Locate element by its aria ref. Refs like `[ref=e2]` are reported by [`method: Page.ariaSnapshot`] when called with
+    # the `"ai"` mode, and resolve against the latest snapshot taken in the element's frame.
+    #
+    # **Usage**
+    #
+    # Consider the following aria snapshot.
+    #
+    # ```yaml
+    # - button "Submit" [ref=e2]
+    # ```
+    #
+    # You can locate the button by its ref:
+    #
+    # ```python sync
+    # page.get_by_ref("e2").click()
+    # ```
+    def get_by_ref(ref)
+      wrap_impl(@impl.get_by_ref(unwrap_impl(ref)))
+    end
+
     #
     # Allows locating elements by their [ARIA role](https://www.w3.org/TR/wai-aria-1.2/#roles), [ARIA attributes](https://www.w3.org/TR/wai-aria-1.2/#aria-attributes) and [accessible name](https://w3c.github.io/accname/#dfn-accessible-name).
     #
@@ -1906,8 +1935,8 @@ module Playwright
     end
 
     # @nodoc
-    def stop_js_coverage
-      wrap_impl(@impl.stop_js_coverage)
+    def snapshot_for_ai(timeout: nil, depth: nil, boxes: nil)
+      wrap_impl(@impl.snapshot_for_ai(timeout: unwrap_impl(timeout), depth: unwrap_impl(depth), boxes: unwrap_impl(boxes)))
     end
 
     # @nodoc
@@ -1916,13 +1945,8 @@ module Playwright
     end
 
     # @nodoc
-    def start_css_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
-      wrap_impl(@impl.start_css_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
-    end
-
-    # @nodoc
-    def snapshot_for_ai(timeout: nil, depth: nil, boxes: nil)
-      wrap_impl(@impl.snapshot_for_ai(timeout: unwrap_impl(timeout), depth: unwrap_impl(depth), boxes: unwrap_impl(boxes)))
+    def stop_js_coverage
+      wrap_impl(@impl.stop_js_coverage)
     end
 
     # @nodoc
@@ -1935,6 +1959,11 @@ module Playwright
       wrap_impl(@impl._assertions(unwrap_impl(timeout), unwrap_impl(is_not), unwrap_impl(message)))
     end
 
+    # @nodoc
+    def start_css_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
+      wrap_impl(@impl.start_css_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
+    end
+
     # @nodoc
     def guid
       wrap_impl(@impl.guid)

data/lib/playwright_api/request.rb

@@ -155,7 +155,7 @@ module Playwright
     #
     # Contains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the
     # following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `eventsource`,
-    # `websocket`, `manifest`, `other`.
+    # `websocket`, `manifest`, `beacon`, `ping`, `cspreport`, `other`.
     def resource_type
       wrap_impl(@impl.resource_type)
     end
@@ -218,13 +218,13 @@ module Playwright
     end
 
     # @nodoc
-    def header_values(name)
-      wrap_impl(@impl.header_values(unwrap_impl(name)))
+    def apply_fallback_overrides(overrides)
+      wrap_impl(@impl.apply_fallback_overrides(unwrap_impl(overrides)))
     end
 
     # @nodoc
-    def apply_fallback_overrides(overrides)
-      wrap_impl(@impl.apply_fallback_overrides(unwrap_impl(overrides)))
+    def header_values(name)
+      wrap_impl(@impl.header_values(unwrap_impl(name)))
     end
 
     # -- inherited from EventEmitter --

data/lib/playwright_api/response.rb

@@ -42,8 +42,9 @@ module Playwright
     end
 
     #
-    # An array with all the request HTTP headers associated with this response. Unlike [`method: Response.allHeaders`], header names are NOT lower-cased.
+    # An array with all the response HTTP headers associated with this response. Unlike [`method: Response.allHeaders`], header names are NOT lower-cased.
     # Headers with multiple entries, such as `Set-Cookie`, appear in the array multiple times.
+    # Some browser network stacks combine multiple field values before reporting them, so separate entries are not always available.
     def headers_array
       wrap_impl(@impl.headers_array)
     end

data/lib/playwright_api/tracing.rb

@@ -19,7 +19,7 @@ module Playwright
   class Tracing < PlaywrightApi
 
     #
-    # Start tracing.
+    # Start tracing. Disposing the returned `Disposable` stops tracing without saving the trace, similarly to calling [`method: Tracing.stop`] without a path.
     #
     # **NOTE**: You probably want to [enable tracing in your config file](https://playwright.dev/docs/api/class-testoptions#test-options-trace) instead of using `Tracing.start`.
     #
@@ -46,7 +46,7 @@ module Playwright
     end
 
     #
-    # Start a new trace chunk. If you'd like to record multiple traces on the same `BrowserContext`, use [`method: Tracing.start`] once, and then create multiple trace chunks with [`method: Tracing.startChunk`] and [`method: Tracing.stopChunk`].
+    # Start a new trace chunk. Disposing the returned `Disposable` stops the chunk without saving it, similarly to calling [`method: Tracing.stopChunk`] without a path. If you'd like to record multiple traces on the same `BrowserContext`, use [`method: Tracing.start`] once, and then create multiple trace chunks with [`method: Tracing.startChunk`] and [`method: Tracing.stopChunk`].
     #
     # **Usage**
     #