playwright-ruby-client 1.20.2 → 1.23.0

data/lib/playwright_api/locator.rb

@@ -2,7 +2,7 @@ module Playwright
   # Locators are the central piece of Playwright's auto-waiting and retry-ability. In a nutshell, locators represent a way
   # to find element(s) on the page at any moment. Locator can be created with the [`method: Page.locator`] method.
   #
-  # [Learn more about locators](./locators.md).
+  # [Learn more about locators](../locators.md).
   class Locator < PlaywrightApi
 
     # Returns an array of `node.innerText` values for all matching nodes.
@@ -39,7 +39,7 @@ module Playwright
     # This method checks the element by performing the following steps:
     # 1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already checked,
     #    this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
@@ -59,7 +59,7 @@ module Playwright
     end
 
     # This method clicks the element by performing the following steps:
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element, or the specified `position`.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
@@ -87,7 +87,7 @@ module Playwright
     end
 
     # This method double clicks the element by performing the following steps:
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to double click in the center of the element, or the specified `position`.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set. Note that if the
@@ -211,7 +211,7 @@ module Playwright
       wrap_impl(@impl.evaluate_handle(unwrap_impl(expression), arg: unwrap_impl(arg), timeout: unwrap_impl(timeout)))
     end
 
-    # This method waits for [actionability](./actionability.md) checks, focuses the element, fills it and triggers an `input`
+    # This method waits for [actionability](../actionability.md) checks, focuses the element, fills it and triggers an `input`
     # event after filling. Note that you can pass an empty string to clear the input field.
     #
     # If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
@@ -224,6 +224,21 @@ module Playwright
       wrap_impl(@impl.fill(unwrap_impl(value), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
+    # This method narrows existing locator according to the options, for example filters by text. It can be chained to filter
+    # multiple times.
+    #
+    # ```python sync
+    # row_locator = page.lsocator("tr")
+    # # ...
+    # row_locator
+    #     .filter(has_text="text in column 1")
+    #     .filter(has=page.locator("tr", has_text="column 2 button"))
+    #     .screenshot()
+    # ```
+    def filter(has: nil, hasText: nil)
+      wrap_impl(@impl.filter(has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
+    end
+
     # Returns locator to the first matching element.
     def first
       wrap_impl(@impl.first)
@@ -257,7 +272,7 @@ module Playwright
     end
 
     # This method hovers over the element by performing the following steps:
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to hover over the center of the element, or the specified `position`.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
@@ -285,7 +300,10 @@ module Playwright
       wrap_impl(@impl.inner_text(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns `input.value` for `<input>` or `<textarea>` or `<select>` element. Throws for non-input elements.
+    # Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
+    #
+    # Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
+    # [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
     def input_value(timeout: nil)
       wrap_impl(@impl.input_value(timeout: unwrap_impl(timeout)))
     end
@@ -295,27 +313,27 @@ module Playwright
       wrap_impl(@impl.checked?(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is disabled, the opposite of [enabled](./actionability.md#enabled).
+    # Returns whether the element is disabled, the opposite of [enabled](../actionability.md#enabled).
     def disabled?(timeout: nil)
       wrap_impl(@impl.disabled?(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [editable](./actionability.md#editable).
+    # Returns whether the element is [editable](../actionability.md#editable).
     def editable?(timeout: nil)
       wrap_impl(@impl.editable?(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [enabled](./actionability.md#enabled).
+    # Returns whether the element is [enabled](../actionability.md#enabled).
     def enabled?(timeout: nil)
       wrap_impl(@impl.enabled?(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is hidden, the opposite of [visible](./actionability.md#visible).
+    # Returns whether the element is hidden, the opposite of [visible](../actionability.md#visible).
     def hidden?(timeout: nil)
       wrap_impl(@impl.hidden?(timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [visible](./actionability.md#visible).
+    # Returns whether the element is [visible](../actionability.md#visible).
     def visible?(timeout: nil)
       wrap_impl(@impl.visible?(timeout: unwrap_impl(timeout)))
     end
@@ -325,12 +343,13 @@ module Playwright
       wrap_impl(@impl.last)
     end
 
-    # The method finds an element matching the specified selector in the `Locator`'s subtree.
+    # The method finds an element matching the specified selector in the `Locator`'s subtree. It also accepts filter options,
+    # similar to [`method: Locator.filter`] method.
     def locator(selector, has: nil, hasText: nil)
       wrap_impl(@impl.locator(unwrap_impl(selector), has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
     end
 
-    # Returns locator to the n-th matching element.
+    # Returns locator to the n-th matching element. It's zero based, `nth(0)` selects the first element.
     def nth(index)
       wrap_impl(@impl.nth(unwrap_impl(index)))
     end
@@ -362,29 +381,35 @@ module Playwright
       wrap_impl(@impl.press(unwrap_impl(key), delay: unwrap_impl(delay), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns the buffer with the captured screenshot.
+    # This method captures a screenshot of the page, clipped to the size and position of a particular element matching the
+    # locator. If the element is covered by other elements, it will not be actually visible on the screenshot. If the element
+    # is a scrollable container, only the currently scrolled content will be visible on the screenshot.
     #
-    # This method waits for the [actionability](./actionability.md) checks, then scrolls element into view before taking a
+    # This method waits for the [actionability](../actionability.md) checks, then scrolls element into view before taking a
     # screenshot. If the element is detached from DOM, the method throws an error.
+    #
+    # Returns the buffer with the captured screenshot.
     def screenshot(
           animations: nil,
+          caret: nil,
           mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
+          scale: nil,
           timeout: nil,
           type: nil)
-      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
+      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), caret: unwrap_impl(caret), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), scale: unwrap_impl(scale), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
     end
 
-    # This method waits for [actionability](./actionability.md) checks, then tries to scroll element into view, unless it is
+    # This method waits for [actionability](../actionability.md) checks, then tries to scroll element into view, unless it is
     # completely visible as defined by
     # [IntersectionObserver](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API)'s `ratio`.
     def scroll_into_view_if_needed(timeout: nil)
       wrap_impl(@impl.scroll_into_view_if_needed(timeout: unwrap_impl(timeout)))
     end
 
-    # This method waits for [actionability](./actionability.md) checks, waits until all specified options are present in the
+    # This method waits for [actionability](../actionability.md) checks, waits until all specified options are present in the
     # `<select>` element and selects these options.
     #
     # If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
@@ -403,17 +428,6 @@ module Playwright
     # # multiple selection
     # element.select_option(value=["red", "green", "blue"])
     # ```
-    #
-    # ```python sync
-    # # single selection matching the value
-    # element.select_option("blue")
-    # # single selection matching both the value and the label
-    # element.select_option(label="blue")
-    # # multiple selection
-    # element.select_option("red", "green", "blue")
-    # # multiple selection for blue, red and second option
-    # element.select_option(value="blue", { index: 2 }, "red")
-    # ```
     def select_option(
           element: nil,
           index: nil,
@@ -425,8 +439,12 @@ module Playwright
       wrap_impl(@impl.select_option(element: unwrap_impl(element), index: unwrap_impl(index), value: unwrap_impl(value), label: unwrap_impl(label), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
-    # This method waits for [actionability](./actionability.md) checks, then focuses the element and selects all its text
+    # This method waits for [actionability](../actionability.md) checks, then focuses the element and selects all its text
     # content.
+    #
+    # If the element is inside the `<label>` element that has an associated
+    # [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), focuses and selects text in the
+    # control instead.
     def select_text(force: nil, timeout: nil)
       wrap_impl(@impl.select_text(force: unwrap_impl(force), timeout: unwrap_impl(timeout)))
     end
@@ -434,7 +452,7 @@ module Playwright
     # This method checks or unchecks an element by performing the following steps:
     # 1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
     # 1. If the element already has the right checked state, this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
@@ -454,18 +472,20 @@ module Playwright
     end
     alias_method :checked=, :set_checked
 
-    # This method expects `element` to point to an
-    # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).
-    #
     # Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-    # are resolved relative to the the current working directory. For empty array, clears the selected files.
+    # are resolved relative to the current working directory. For empty array, clears the selected files.
+    #
+    # This method expects `Locator` to point to an
+    # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
+    # `<label>` element that has an associated
+    # [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
     def set_input_files(files, noWaitAfter: nil, timeout: nil)
       wrap_impl(@impl.set_input_files(unwrap_impl(files), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
     alias_method :input_files=, :set_input_files
 
     # This method taps the element by performing the following steps:
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.touchscreen`] to tap the center of the element, or the specified `position`.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.
@@ -514,7 +534,7 @@ module Playwright
     # This method checks the element by performing the following steps:
     # 1. Ensure that element is a checkbox or a radio input. If not, this method throws. If the element is already
     #    unchecked, this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the element, unless `force` option is set.
+    # 1. Wait for [actionability](../actionability.md) checks on the element, unless `force` option is set.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
     # 1. Wait for initiated navigations to either succeed or fail, unless `noWaitAfter` option is set.

data/lib/playwright_api/page.rb

@@ -56,7 +56,8 @@ module Playwright
       wrap_impl(@impl.mouse)
     end
 
-    # API testing helper associated with this page. Requests made with this API will use page cookies.
+    # API testing helper associated with this page. This method returns the same instance as
+    # [`property: BrowserContext.request`] on the page's context. See [`property: BrowserContext.request`] for more details.
     def request # property
       wrap_impl(@impl.request)
     end
@@ -111,7 +112,7 @@ module Playwright
     # 1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
     # 1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
     #    checked, this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
@@ -135,7 +136,7 @@ module Playwright
 
     # This method clicks 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.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element, or the specified `position`.
@@ -183,7 +184,7 @@ module Playwright
 
     # This method double clicks 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.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to double click in the center of the element, or the specified `position`.
@@ -501,7 +502,7 @@ module Playwright
       wrap_impl(@impl.expose_function(unwrap_impl(name), unwrap_impl(callback)))
     end
 
-    # This method waits for an element matching `selector`, waits for [actionability](./actionability.md) checks, focuses the
+    # This method waits for an element matching `selector`, waits for [actionability](../actionability.md) checks, focuses the
     # element, fills it and triggers an `input` event after filling. Note that you can pass an empty string to clear the input
     # field.
     #
@@ -582,8 +583,8 @@ module Playwright
       wrap_impl(@impl.go_forward(timeout: unwrap_impl(timeout), waitUntil: unwrap_impl(waitUntil)))
     end
 
-    # Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-    # last redirect.
+    # Returns the main resource response. In case of multiple redirects, the navigation will resolve with the first
+    # non-redirect response.
     #
     # The method will throw an error if:
     # - there's an SSL error (e.g. in case of self-signed certificates).
@@ -608,7 +609,7 @@ module Playwright
 
     # This method hovers over 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.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to hover over the center of the element, or the specified `position`.
@@ -639,7 +640,10 @@ module Playwright
       wrap_impl(@impl.inner_text(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element. Throws for non-input elements.
+    # Returns `input.value` for the selected `<input>` or `<textarea>` or `<select>` element.
+    #
+    # Throws for non-input elements. However, if the element is inside the `<label>` element that has an associated
+    # [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), returns the value of the control.
     def input_value(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.input_value(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
@@ -654,28 +658,28 @@ module Playwright
       wrap_impl(@impl.closed?)
     end
 
-    # Returns whether the element is disabled, the opposite of [enabled](./actionability.md#enabled).
+    # Returns whether the element is disabled, the opposite of [enabled](../actionability.md#enabled).
     def disabled?(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.disabled?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [editable](./actionability.md#editable).
+    # Returns whether the element is [editable](../actionability.md#editable).
     def editable?(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.editable?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [enabled](./actionability.md#enabled).
+    # Returns whether the element is [enabled](../actionability.md#enabled).
     def enabled?(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.enabled?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is hidden, the opposite of [visible](./actionability.md#visible).  `selector` that does not
+    # Returns whether the element is hidden, the opposite of [visible](../actionability.md#visible).  `selector` that does not
     # match any elements is considered hidden.
     def hidden?(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.hidden?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns whether the element is [visible](./actionability.md#visible). `selector` that does not match any elements is
+    # Returns whether the element is [visible](../actionability.md#visible). `selector` that does not match any elements is
     # considered not visible.
     def visible?(selector, strict: nil, timeout: nil)
       wrap_impl(@impl.visible?(unwrap_impl(selector), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
@@ -685,6 +689,8 @@ module Playwright
     # element immediately before performing an action, so a series of actions on the same locator can in fact be performed on
     # different DOM elements. That would happen if the DOM structure between those actions has changed.
     #
+    # [Learn more about locators](../locators.md).
+    #
     # Shortcut for main frame's [`method: Frame.locator`].
     def locator(selector, has: nil, hasText: nil)
       wrap_impl(@impl.locator(unwrap_impl(selector), has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
@@ -847,7 +853,7 @@ module Playwright
     # > NOTE: The handler will only be called for the first url if the response is a redirect.
     # > NOTE: [`method: Page.route`] will not intercept requests intercepted by Service Worker. See
     # [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-    # request interception. Via `await context.addInitScript(() => delete window.navigator.serviceWorker);`
+    # request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
     #
     # An example of a naive handler that aborts all image requests:
     #
@@ -889,21 +895,33 @@ module Playwright
       wrap_impl(@impl.route(unwrap_impl(url), unwrap_impl(handler), times: unwrap_impl(times)))
     end
 
+    # If specified the network requests that are made in the page will be served from the HAR file. Read more about
+    # [Replaying from HAR](../network.md#replaying-from-har).
+    #
+    # Playwright will not serve requests intercepted by Service Worker from the HAR file. See
+    # [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
+    # request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+    def route_from_har(har, notFound: nil, update: nil, url: nil)
+      wrap_impl(@impl.route_from_har(unwrap_impl(har), notFound: unwrap_impl(notFound), update: unwrap_impl(update), url: unwrap_impl(url)))
+    end
+
     # Returns the buffer with the captured screenshot.
     def screenshot(
           animations: nil,
+          caret: nil,
           clip: nil,
           fullPage: nil,
           mask: nil,
           omitBackground: nil,
           path: nil,
           quality: nil,
+          scale: nil,
           timeout: nil,
           type: nil)
-      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), clip: unwrap_impl(clip), fullPage: unwrap_impl(fullPage), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
+      wrap_impl(@impl.screenshot(animations: unwrap_impl(animations), caret: unwrap_impl(caret), clip: unwrap_impl(clip), fullPage: unwrap_impl(fullPage), mask: unwrap_impl(mask), omitBackground: unwrap_impl(omitBackground), path: unwrap_impl(path), quality: unwrap_impl(quality), scale: unwrap_impl(scale), timeout: unwrap_impl(timeout), type: unwrap_impl(type)))
     end
 
-    # This method waits for an element matching `selector`, waits for [actionability](./actionability.md) checks, waits until
+    # This method waits for an element matching `selector`, waits for [actionability](../actionability.md) checks, waits until
     # all specified options are present in the `<select>` element and selects these options.
     #
     # If the target element is not a `<select>` element, this method throws an error. However, if the element is inside the
@@ -941,7 +959,7 @@ module Playwright
     # 1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
     # 1. Ensure that matched element is a checkbox or a radio input. If not, this method throws.
     # 1. If the element already has the right checked state, this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
@@ -1001,11 +1019,13 @@ module Playwright
     end
     alias_method :extra_http_headers=, :set_extra_http_headers
 
-    # This method expects `selector` to point to an
-    # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).
-    #
     # Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
-    # are resolved relative to the the current working directory. For empty array, clears the selected files.
+    # are resolved relative to the current working directory. For empty array, clears the selected files.
+    #
+    # This method expects `selector` to point to an
+    # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input). However, if the element is inside the
+    # `<label>` element that has an associated
+    # [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), targets the control instead.
     def set_input_files(
           selector,
           files,
@@ -1035,7 +1055,7 @@ module Playwright
 
     # 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.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.touchscreen`] to tap the center of the element, or the specified `position`.
@@ -1094,7 +1114,7 @@ module Playwright
     # 1. Find an element matching `selector`. If there is none, wait until a matching element is attached to the DOM.
     # 1. Ensure that matched element is a checkbox or a radio input. If not, this method throws. If the element is already
     #    unchecked, this method returns immediately.
-    # 1. Wait for [actionability](./actionability.md) checks on the matched element, unless `force` option is set. If the
+    # 1. Wait for [actionability](../actionability.md) checks on the matched element, unless `force` option is set. If the
     #    element is detached during the checks, the whole action is retried.
     # 1. Scroll the element into view if needed.
     # 1. Use [`property: Page.mouse`] to click in the center of the element.
@@ -1252,7 +1272,7 @@ module Playwright
       wrap_impl(@impl.expect_popup(predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
-    # Waits for the matching request and returns it. See [waiting for event](./events.md#waiting-for-event) for more details
+    # Waits for the matching request and returns it. See [waiting for event](../events.md#waiting-for-event) for more details
     # about events.
     #
     # ```python sync
@@ -1276,7 +1296,7 @@ module Playwright
       wrap_impl(@impl.expect_request_finished(predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
-    # Returns the matched response. See [waiting for event](./events.md#waiting-for-event) for more details about events.
+    # Returns the matched response. See [waiting for event](../events.md#waiting-for-event) for more details about events.
     #
     # ```python sync
     # with page.expect_response("https://example.com/resource") as response_info:
@@ -1395,8 +1415,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)))
+    def guid
+      wrap_impl(@impl.guid)
     end
 
     # @nodoc
@@ -1405,13 +1425,13 @@ module Playwright
     end
 
     # @nodoc
-    def stop_css_coverage
-      wrap_impl(@impl.stop_css_coverage)
+    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)
+    def stop_css_coverage
+      wrap_impl(@impl.stop_css_coverage)
     end
 
     # -- inherited from EventEmitter --

data/lib/playwright_api/playwright.rb

@@ -55,7 +55,7 @@ module Playwright
       raise NotImplementedError.new('request is not implemented yet.')
     end
 
-    # Selectors can be used to install custom selector engines. See [Working with selectors](./selectors.md) for more
+    # Selectors can be used to install custom selector engines. See [Working with selectors](../selectors.md) for more
     # information.
     def selectors # property
       wrap_impl(@impl.selectors)

data/lib/playwright_api/request.rb

@@ -35,7 +35,9 @@ module Playwright
       wrap_impl(@impl.frame)
     end
 
-    # **DEPRECATED** Incomplete list of headers as seen by the rendering engine. Use [`method: Request.allHeaders`] instead.
+    # An object with the request HTTP headers. The header names are lower-cased. Note that this method does not return
+    # security-related headers, including cookie-related ones. You can use [`method: Request.allHeaders`] for complete list of
+    # headers that include `cookie` information.
     def headers
       wrap_impl(@impl.headers)
     end
@@ -149,6 +151,11 @@ module Playwright
       wrap_impl(@impl.url)
     end
 
+    # @nodoc
+    def apply_fallback_overrides(overrides)
+      wrap_impl(@impl.apply_fallback_overrides(unwrap_impl(overrides)))
+    end
+
     # @nodoc
     def header_values(name)
       wrap_impl(@impl.header_values(unwrap_impl(name)))

data/lib/playwright_api/response.rb

@@ -22,7 +22,15 @@ module Playwright
       wrap_impl(@impl.frame)
     end
 
-    # **DEPRECATED** Incomplete list of headers as seen by the rendering engine. Use [`method: Response.allHeaders`] instead.
+    # Indicates whether this Response was fullfilled by a Service Worker's Fetch Handler (i.e. via
+    # [FetchEvent.respondWith](https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/respondWith)).
+    def from_service_worker
+      wrap_impl(@impl.from_service_worker)
+    end
+
+    # An object with the response HTTP headers. The header names are lower-cased. Note that this method does not return
+    # security-related headers, including cookie-related ones. You can use [`method: Response.allHeaders`] for complete list
+    # of headers that include `cookie` information.
     def headers
       wrap_impl(@impl.headers)
     end
@@ -92,6 +100,11 @@ module Playwright
       wrap_impl(@impl.url)
     end
 
+    # @nodoc
+    def from_service_worker?
+      wrap_impl(@impl.from_service_worker?)
+    end
+
     # @nodoc
     def ok?
       wrap_impl(@impl.ok?)

data/lib/playwright_api/route.rb

@@ -1,6 +1,8 @@
 module Playwright
   # Whenever a network route is set up with [`method: Page.route`] or [`method: BrowserContext.route`], the `Route` object
   # allows to handle the route.
+  #
+  # Learn more about [networking](../network.md).
   class Route < PlaywrightApi
 
     # Aborts the route's request.
@@ -15,8 +17,8 @@ module Playwright
     #     # override headers
     #     headers = {
     #         **request.headers,
-    #         "foo": "bar" # set "foo" header
-    #         "origin": None # remove "origin" header
+    #         "foo": "foo-value" # set "foo" header
+    #         "bar": None # remove "bar" header
     #     }
     #     route.continue_(headers=headers)
     # }
@@ -26,6 +28,60 @@ module Playwright
       wrap_impl(@impl.continue(headers: unwrap_impl(headers), method: unwrap_impl(method), postData: unwrap_impl(postData), url: unwrap_impl(url)))
     end
 
+    # When several routes match the given pattern, they run in the order opposite to their registration. That way the last
+    # registered route can always override all the previos ones. In the example below, request will be handled by the
+    # bottom-most handler first, then it'll fall back to the previous one and in the end will be aborted by the first
+    # registered route.
+    #
+    # ```python sync
+    # page.route("**/*", lambda route: route.abort())  # Runs last.
+    # page.route("**/*", lambda route: route.fallback())  # Runs second.
+    # page.route("**/*", lambda route: route.fallback())  # Runs first.
+    # ```
+    #
+    # Registering multiple routes is useful when you want separate handlers to handle different kinds of requests, for example
+    # API calls vs page resources or GET requests vs POST requests as in the example below.
+    #
+    # ```python sync
+    # # Handle GET requests.
+    # def handle_post(route):
+    #     if route.request.method != "GET":
+    #         route.fallback()
+    #         return
+    #   # Handling GET only.
+    #   # ...
+    #
+    # # Handle POST requests.
+    # def handle_post(route):
+    #     if route.request.method != "POST":
+    #         route.fallback()
+    #         return
+    #   # Handling POST only.
+    #   # ...
+    #
+    # page.route("**/*", handle_get)
+    # page.route("**/*", handle_post)
+    # ```
+    #
+    # One can also modify request while falling back to the subsequent handler, that way intermediate route handler can modify
+    # url, method, headers and postData of the request.
+    #
+    # ```python sync
+    # def handle(route, request):
+    #     # override headers
+    #     headers = {
+    #         **request.headers,
+    #         "foo": "foo-value" # set "foo" header
+    #         "bar": None # remove "bar" header
+    #     }
+    #     route.fallback(headers=headers)
+    # }
+    # page.route("**/*", handle)
+    # ```
+    def fallback(headers: nil, method: nil, postData: nil, url: nil)
+      wrap_impl(@impl.fallback(headers: unwrap_impl(headers), method: unwrap_impl(method), postData: unwrap_impl(postData), url: unwrap_impl(url)))
+    end
+
     # Fulfills route's request with given response.
     #
     # An example of fulfilling all requests with 404 responses:
@@ -57,6 +113,11 @@ module Playwright
       wrap_impl(@impl.request)
     end
 
+    # @nodoc
+    def redirect_navigation_request(url)
+      wrap_impl(@impl.redirect_navigation_request(unwrap_impl(url)))
+    end
+
     # -- inherited from EventEmitter --
     # @nodoc
     def off(event, callback)