playwright-ruby-client 1.57.0 → 1.59.0

data/lib/playwright_api/browser_context.rb

@@ -25,6 +25,12 @@ module Playwright
       wrap_impl(@impl.clock)
     end
 
+    #
+    # Debugger allows to pause and resume the execution.
+    def debugger # property
+      raise NotImplementedError.new('debugger is not implemented yet.')
+    end
+
     #
     # API testing helper associated with this context. Requests made with this API will use context cookies.
     def request # property
@@ -226,6 +232,12 @@ module Playwright
       wrap_impl(@impl.grant_permissions(unwrap_impl(permissions), origin: unwrap_impl(origin)))
     end
 
+    #
+    # Indicates that the browser context is in the process of closing or has already been closed.
+    def closed?
+      wrap_impl(@impl.closed?)
+    end
+
     #
     # **NOTE**: CDP sessions are only supported on Chromium-based browsers.
     #
@@ -409,6 +421,20 @@ module Playwright
       wrap_impl(@impl.storage_state(indexedDB: unwrap_impl(indexedDB), path: unwrap_impl(path)))
     end
 
+    #
+    # Clears the existing cookies, local storage and IndexedDB entries for all origins and sets the new storage state.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # # Load storage state from a file and apply it to the context.
+    # context.set_storage_state("state.json")
+    # ```
+    def set_storage_state(storageState)
+      wrap_impl(@impl.set_storage_state(unwrap_impl(storageState)))
+    end
+    alias_method :storage_state=, :set_storage_state
+
     #
     # Removes all routes created with [`method: BrowserContext.route`] and [`method: BrowserContext.routeFromHAR`].
     def unroute_all(behavior: nil)
@@ -488,12 +514,6 @@ module Playwright
       wrap_impl(@impl.browser=(unwrap_impl(req)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -506,6 +526,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/browser_type.rb

@@ -24,7 +24,7 @@ module Playwright
     #
     # **NOTE**: The major and minor version of the Playwright instance that connects needs to match the version of Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
     def connect(
-          wsEndpoint,
+          endpoint,
           exposeNetwork: nil,
           headers: nil,
           slowMo: nil,
@@ -51,10 +51,11 @@ module Playwright
     def connect_over_cdp(
           endpointURL,
           headers: nil,
+          isLocal: nil,
           slowMo: nil,
           timeout: nil,
           &block)
-      wrap_impl(@impl.connect_over_cdp(unwrap_impl(endpointURL), headers: unwrap_impl(headers), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
+      wrap_impl(@impl.connect_over_cdp(unwrap_impl(endpointURL), headers: unwrap_impl(headers), isLocal: unwrap_impl(isLocal), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
     #
@@ -93,9 +94,9 @@ module Playwright
     # describes some differences for Linux users.
     def launch(
           args: nil,
+          artifactsDir: nil,
           channel: nil,
           chromiumSandbox: nil,
-          devtools: nil,
           downloadsPath: nil,
           env: nil,
           executablePath: nil,
@@ -110,7 +111,7 @@ module Playwright
           timeout: nil,
           tracesDir: nil,
           &block)
-      wrap_impl(@impl.launch(args: unwrap_impl(args), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), headless: unwrap_impl(headless), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), proxy: unwrap_impl(proxy), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), tracesDir: unwrap_impl(tracesDir), &wrap_block_call(block)))
+      wrap_impl(@impl.launch(args: unwrap_impl(args), artifactsDir: unwrap_impl(artifactsDir), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), headless: unwrap_impl(headless), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), proxy: unwrap_impl(proxy), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), tracesDir: unwrap_impl(tracesDir), &wrap_block_call(block)))
     end
 
     #
@@ -122,6 +123,7 @@ module Playwright
           userDataDir,
           acceptDownloads: nil,
           args: nil,
+          artifactsDir: nil,
           baseURL: nil,
           bypassCSP: nil,
           channel: nil,
@@ -130,7 +132,6 @@ module Playwright
           colorScheme: nil,
           contrast: nil,
           deviceScaleFactor: nil,
-          devtools: nil,
           downloadsPath: nil,
           env: nil,
           executablePath: nil,
@@ -171,7 +172,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), 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), devtools: unwrap_impl(devtools), 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_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
 
     #
@@ -180,12 +181,6 @@ module Playwright
       wrap_impl(@impl.name)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -198,6 +193,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/cdp_session.rb

@@ -31,12 +31,6 @@ module Playwright
       wrap_impl(@impl.send_message(unwrap_impl(method), params: unwrap_impl(params)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -49,6 +43,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/console_message.rb

@@ -45,6 +45,12 @@ module Playwright
       wrap_impl(@impl.text)
     end
 
+    #
+    # The timestamp of the console message in milliseconds since the Unix epoch.
+    def timestamp
+      wrap_impl(@impl.timestamp)
+    end
+
     def type
       wrap_impl(@impl.type)
     end

data/lib/playwright_api/dialog.rb

@@ -68,12 +68,6 @@ module Playwright
       wrap_impl(@impl.accept_async(promptText: unwrap_impl(promptText)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -86,6 +80,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/element_handle.rb

@@ -574,12 +574,6 @@ module Playwright
       wrap_impl(@impl.wait_for_selector(unwrap_impl(selector), state: unwrap_impl(state), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -592,6 +586,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame.rb

@@ -436,7 +436,7 @@ module Playwright
     # <button>Submit</button>
     # ```
     #
-    # You can locate each element by it's implicit role:
+    # You can locate each element by its implicit role:
     #
     # ```python sync
     # expect(page.get_by_role("heading", name="Sign up")).to_be_visible()
@@ -476,7 +476,7 @@ module Playwright
     # <button data-testid="directions">Itinéraire</button>
     # ```
     #
-    # You can locate the element by it's test id:
+    # You can locate the element by its test id:
     #
     # ```python sync
     # page.get_by_test_id("directions").click()
@@ -1055,12 +1055,6 @@ module Playwright
       wrap_impl(@impl.detached=(unwrap_impl(req)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -1073,6 +1067,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame_locator.rb

@@ -118,7 +118,7 @@ module Playwright
     # <button>Submit</button>
     # ```
     #
-    # You can locate each element by it's implicit role:
+    # You can locate each element by its implicit role:
     #
     # ```python sync
     # expect(page.get_by_role("heading", name="Sign up")).to_be_visible()
@@ -158,7 +158,7 @@ module Playwright
     # <button data-testid="directions">Itinéraire</button>
     # ```
     #
-    # You can locate the element by it's test id:
+    # You can locate the element by its test id:
     #
     # ```python sync
     # page.get_by_test_id("directions").click()

data/lib/playwright_api/js_handle.rb

@@ -98,12 +98,6 @@ module Playwright
       wrap_impl(@impl.to_s)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -116,6 +110,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/locator.rb

@@ -103,8 +103,11 @@ module Playwright
     #   - listitem:
     #     - link "About"
     # ```
-    def aria_snapshot(timeout: nil)
-      wrap_impl(@impl.aria_snapshot(timeout: unwrap_impl(timeout)))
+    #
+    # An AI-optimized snapshot, controlled by `mode`, is different from a default snapshot:
+    # 1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when no elements match. 3. Includes snapshots of `<iframe>`s inside the target.
+    def aria_snapshot(depth: nil, mode: nil, timeout: nil)
+      wrap_impl(@impl.aria_snapshot(depth: unwrap_impl(depth), mode: unwrap_impl(mode), timeout: unwrap_impl(timeout)))
     end
 
     #
@@ -291,7 +294,7 @@ module Playwright
     end
 
     #
-    # Returns locator description previously set with [`method: Locator.describe`]. Returns `null` if no custom description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the description when available.
+    # Returns locator description previously set with [`method: Locator.describe`]. Returns `null` if no custom description has been set.
     #
     # **Usage**
     #
@@ -628,7 +631,7 @@ module Playwright
     # <button>Submit</button>
     # ```
     #
-    # You can locate each element by it's implicit role:
+    # You can locate each element by its implicit role:
     #
     # ```python sync
     # expect(page.get_by_role("heading", name="Sign up")).to_be_visible()
@@ -668,7 +671,7 @@ module Playwright
     # <button data-testid="directions">Itinéraire</button>
     # ```
     #
-    # You can locate the element by it's test id:
+    # You can locate the element by its test id:
     #
     # ```python sync
     # page.get_by_test_id("directions").click()
@@ -921,6 +924,13 @@ module Playwright
       wrap_impl(@impl.locator(unwrap_impl(selectorOrLocator), has: unwrap_impl(has), hasNot: unwrap_impl(hasNot), hasNotText: unwrap_impl(hasNotText), hasText: unwrap_impl(hasText)))
     end
 
+    #
+    # 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.
+    def normalize
+      wrap_impl(@impl.normalize)
+    end
+
     #
     # Returns locator to the n-th matching element. It's zero based, `nth(0)` selects the first element.
     #
@@ -1287,13 +1297,13 @@ module Playwright
     end
 
     # @nodoc
-    def expect(expression, options, title)
-      wrap_impl(@impl.expect(unwrap_impl(expression), unwrap_impl(options), unwrap_impl(title)))
+    def resolve_selector
+      wrap_impl(@impl.resolve_selector)
     end
 
     # @nodoc
-    def resolve_selector
-      wrap_impl(@impl.resolve_selector)
+    def expect(expression, options, title)
+      wrap_impl(@impl.expect(unwrap_impl(expression), unwrap_impl(options), unwrap_impl(title)))
     end
 
     # @nodoc

data/lib/playwright_api/locator_assertions.rb

@@ -413,7 +413,7 @@ module Playwright
     # from playwright.sync_api import expect
     #
     # # ✓ Contains the right items in the right order
-    # expect(page.locator("ul > li")).to_contain_text(["Text 1", "Text 3", "Text 4"])
+    # expect(page.locator("ul > li")).to_contain_text(["Text 1", "Text 3"])
     #
     # # ✖ Wrong order
     # expect(page.locator("ul > li")).to_contain_text(["Text 3", "Text 2"])

data/lib/playwright_api/page.rb

@@ -64,6 +64,14 @@ module Playwright
       wrap_impl(@impl.request)
     end
 
+    #
+    # `Screencast` object associated with this page.
+    #
+    # **Usage**
+    def screencast # property
+      wrap_impl(@impl.screencast)
+    end
+
     def touchscreen # property
       wrap_impl(@impl.touchscreen)
     end
@@ -111,6 +119,13 @@ module Playwright
       wrap_impl(@impl.bring_to_front)
     end
 
+    #
+    # Cancels an ongoing [`method: Page.pickLocator`] call by deactivating pick locator mode.
+    # If no pick locator mode is active, this method is a no-op.
+    def cancel_pick_locator
+      wrap_impl(@impl.cancel_pick_locator)
+    end
+
     #
     # This method checks an element matching `selector` by performing the following steps:
     # 1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
@@ -661,7 +676,7 @@ module Playwright
     # <button>Submit</button>
     # ```
     #
-    # You can locate each element by it's implicit role:
+    # You can locate each element by its implicit role:
     #
     # ```python sync
     # expect(page.get_by_role("heading", name="Sign up")).to_be_visible()
@@ -701,7 +716,7 @@ module Playwright
     # <button data-testid="directions">Itinéraire</button>
     # ```
     #
-    # You can locate the element by it's test id:
+    # You can locate the element by its test id:
     #
     # ```python sync
     # page.get_by_test_id("directions").click()
@@ -919,16 +934,28 @@ module Playwright
       wrap_impl(@impl.visible?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
+    #
+    # Clears all stored console messages from this page. Subsequent calls to [`method: Page.consoleMessages`] will only return messages logged after the clear.
+    def clear_console_messages
+      wrap_impl(@impl.clear_console_messages)
+    end
+
+    #
+    # Clears all stored page errors from this page. Subsequent calls to [`method: Page.pageErrors`] will only return errors thrown after the clear.
+    def clear_page_errors
+      wrap_impl(@impl.clear_page_errors)
+    end
+
     #
     # Returns up to (currently) 200 last console messages from this page. See [`event: Page.console`] for more details.
-    def console_messages
-      wrap_impl(@impl.console_messages)
+    def console_messages(filter: nil)
+      wrap_impl(@impl.console_messages(filter: unwrap_impl(filter)))
     end
 
     #
     # Returns up to (currently) 200 last page errors from this page. See [`event: Page.pageError`] for more details.
-    def page_errors
-      wrap_impl(@impl.page_errors)
+    def page_errors(filter: nil)
+      wrap_impl(@impl.page_errors(filter: unwrap_impl(filter)))
     end
 
     #
@@ -1035,6 +1062,20 @@ module Playwright
       wrap_impl(@impl.pdf(displayHeaderFooter: unwrap_impl(displayHeaderFooter), footerTemplate: unwrap_impl(footerTemplate), format: unwrap_impl(format), headerTemplate: unwrap_impl(headerTemplate), height: unwrap_impl(height), landscape: unwrap_impl(landscape), margin: unwrap_impl(margin), outline: unwrap_impl(outline), pageRanges: unwrap_impl(pageRanges), path: unwrap_impl(path), preferCSSPageSize: unwrap_impl(preferCSSPageSize), printBackground: unwrap_impl(printBackground), scale: unwrap_impl(scale), tagged: unwrap_impl(tagged), width: unwrap_impl(width)))
     end
 
+    #
+    # Enters pick locator mode where hovering over page elements highlights them and shows the corresponding locator.
+    # Once the user clicks an element, the mode is deactivated and the `Locator` for the picked element is returned.
+    #
+    # **Usage**
+    #
+    # ```python sync
+    # locator = page.pick_locator()
+    # print(locator)
+    # ```
+    def pick_locator
+      wrap_impl(@impl.pick_locator)
+    end
+
     #
     # Focuses the element, and then uses [`method: Keyboard.down`] and [`method: Keyboard.up`].
     #
@@ -1230,6 +1271,8 @@ module Playwright
     # page.route("/api/**", handle_route)
     # ```
     #
+    # If a request matches multiple registered routes, the most recently registered route takes precedence.
+    #
     # Page routes take precedence over browser context routes (set up with [`method: BrowserContext.route`]) when request
     # matches both handlers.
     #
@@ -1429,6 +1472,12 @@ module Playwright
     end
     alias_method :viewport_size=, :set_viewport_size
 
+    #
+    # Captures the aria snapshot of the page. Read more about [aria snapshots](../aria-snapshots.md).
+    def aria_snapshot(depth: nil, mode: nil, timeout: nil)
+      wrap_impl(@impl.aria_snapshot(depth: unwrap_impl(depth), mode: unwrap_impl(mode), timeout: unwrap_impl(timeout)))
+    end
+
     #
     # This method taps an element matching `selector` by performing the following steps:
     # 1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
@@ -1523,7 +1572,7 @@ module Playwright
     end
 
     #
-    # Video object associated with this page.
+    # Video object associated with this page. Can be used to access the video file when using the `recordVideo` context option.
     def video
       wrap_impl(@impl.video)
     end
@@ -1818,13 +1867,13 @@ module Playwright
     end
 
     # @nodoc
-    def snapshot_for_ai(timeout: nil, mode: nil, track: nil)
-      wrap_impl(@impl.snapshot_for_ai(timeout: unwrap_impl(timeout), mode: unwrap_impl(mode), track: unwrap_impl(track)))
+    def owned_context=(req)
+      wrap_impl(@impl.owned_context=(unwrap_impl(req)))
     end
 
     # @nodoc
-    def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
-      wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
+    def stop_js_coverage
+      wrap_impl(@impl.stop_js_coverage)
     end
 
     # @nodoc
@@ -1833,24 +1882,18 @@ module Playwright
     end
 
     # @nodoc
-    def stop_css_coverage
-      wrap_impl(@impl.stop_css_coverage)
-    end
-
-    # @nodoc
-    def owned_context=(req)
-      wrap_impl(@impl.owned_context=(unwrap_impl(req)))
+    def snapshot_for_ai(timeout: nil, depth: nil, _track: nil)
+      wrap_impl(@impl.snapshot_for_ai(timeout: unwrap_impl(timeout), depth: unwrap_impl(depth), _track: unwrap_impl(_track)))
     end
 
     # @nodoc
-    def stop_js_coverage
-      wrap_impl(@impl.stop_js_coverage)
+    def stop_css_coverage
+      wrap_impl(@impl.stop_css_coverage)
     end
 
-    # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
+      wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
     end
 
     # -- inherited from EventEmitter --
@@ -1865,6 +1908,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/playwright.rb

@@ -103,12 +103,6 @@ module Playwright
       wrap_impl(@impl.electron)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -121,6 +115,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end