playwright-ruby-client 1.20.2 → 1.21.0

data/lib/playwright_api/element_handle.rb

@@ -66,7 +66,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.
@@ -86,7 +86,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.
@@ -114,7 +114,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
@@ -172,7 +172,7 @@ module Playwright
     # Returns the return value of `expression`.
     #
     # The method finds an element matching the specified selector in the `ElementHandle`s subtree and passes it as a first
-    # argument to `expression`. See [Working with selectors](./selectors.md) for more details. If no elements match the
+    # argument to `expression`. See [Working with selectors](../selectors.md) for more details. If no elements match the
     # selector, the method throws an error.
     #
     # If `expression` returns a [Promise], then [`method: ElementHandle.evalOnSelector`] would wait for the promise to resolve
@@ -192,7 +192,7 @@ module Playwright
     # Returns the return value of `expression`.
     #
     # The method finds all elements matching the specified selector in the `ElementHandle`'s subtree and passes an array of
-    # matched elements as a first argument to `expression`. See [Working with selectors](./selectors.md) for more details.
+    # matched elements as a first argument to `expression`. See [Working with selectors](../selectors.md) for more details.
     #
     # If `expression` returns a [Promise], then [`method: ElementHandle.evalOnSelectorAll`] would wait for the promise to
     # resolve and return its value.
@@ -214,7 +214,7 @@ module Playwright
       wrap_impl(@impl.eval_on_selector_all(unwrap_impl(selector), unwrap_impl(expression), arg: unwrap_impl(arg)))
     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.
@@ -239,7 +239,7 @@ module Playwright
     alias_method :[], :get_attribute
 
     # 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.
@@ -277,27 +277,27 @@ module Playwright
       wrap_impl(@impl.checked?)
     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?
       wrap_impl(@impl.disabled?)
     end
 
-    # Returns whether the element is [editable](./actionability.md#editable).
+    # Returns whether the element is [editable](../actionability.md#editable).
     def editable?
       wrap_impl(@impl.editable?)
     end
 
-    # Returns whether the element is [enabled](./actionability.md#enabled).
+    # Returns whether the element is [enabled](../actionability.md#enabled).
     def enabled?
       wrap_impl(@impl.enabled?)
     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?
       wrap_impl(@impl.hidden?)
     end
 
-    # Returns whether the element is [visible](./actionability.md#visible).
+    # Returns whether the element is [visible](../actionability.md#visible).
     def visible?
       wrap_impl(@impl.visible?)
     end
@@ -330,33 +330,35 @@ module Playwright
     end
 
     # The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See
-    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns `null`.
+    # [Working with selectors](../selectors.md) for more details. If no elements match the selector, returns `null`.
     def query_selector(selector)
       wrap_impl(@impl.query_selector(unwrap_impl(selector)))
     end
 
     # The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See
-    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns empty array.
+    # [Working with selectors](../selectors.md) for more details. If no elements match the selector, returns empty array.
     def query_selector_all(selector)
       wrap_impl(@impl.query_selector_all(unwrap_impl(selector)))
     end
 
     # Returns the buffer with the captured 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.
     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`.
     #
@@ -366,7 +368,7 @@ module Playwright
       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
@@ -407,7 +409,7 @@ 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.
     def select_text(force: nil, timeout: nil)
       wrap_impl(@impl.select_text(force: unwrap_impl(force), timeout: unwrap_impl(timeout)))
@@ -416,7 +418,7 @@ module Playwright
     # This method checks or unchecks an element by performing the following steps:
     # 1. Ensure that 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.
@@ -447,7 +449,7 @@ module Playwright
     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.
@@ -496,7 +498,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.
@@ -517,16 +519,16 @@ module Playwright
 
     # Returns when the element satisfies the `state`.
     #
-    # Depending on the `state` parameter, this method waits for one of the [actionability](./actionability.md) checks to pass.
-    # This method throws when the element is detached while waiting, unless waiting for the `"hidden"` state.
-    # - `"visible"` Wait until the element is [visible](./actionability.md#visible).
-    # - `"hidden"` Wait until the element is [not visible](./actionability.md#visible) or
-    #   [not attached](./actionability.md#attached). Note that waiting for hidden does not throw when the element detaches.
-    # - `"stable"` Wait until the element is both [visible](./actionability.md#visible) and
-    #   [stable](./actionability.md#stable).
-    # - `"enabled"` Wait until the element is [enabled](./actionability.md#enabled).
-    # - `"disabled"` Wait until the element is [not enabled](./actionability.md#enabled).
-    # - `"editable"` Wait until the element is [editable](./actionability.md#editable).
+    # Depending on the `state` parameter, this method waits for one of the [actionability](../actionability.md) checks to
+    # pass. This method throws when the element is detached while waiting, unless waiting for the `"hidden"` state.
+    # - `"visible"` Wait until the element is [visible](../actionability.md#visible).
+    # - `"hidden"` Wait until the element is [not visible](../actionability.md#visible) or
+    #   [not attached](../actionability.md#attached). Note that waiting for hidden does not throw when the element detaches.
+    # - `"stable"` Wait until the element is both [visible](../actionability.md#visible) and
+    #   [stable](../actionability.md#stable).
+    # - `"enabled"` Wait until the element is [enabled](../actionability.md#enabled).
+    # - `"disabled"` Wait until the element is [not enabled](../actionability.md#enabled).
+    # - `"editable"` Wait until the element is [editable](../actionability.md#editable).
     #
     # If the element does not satisfy the condition for the `timeout` milliseconds, this method will throw.
     def wait_for_element_state(state, timeout: nil)
@@ -553,12 +555,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 off(event, callback)
-      event_emitter_proxy.off(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def once(event, callback)
@@ -571,6 +567,12 @@ module Playwright
       event_emitter_proxy.on(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame.rb

@@ -51,7 +51,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.
@@ -77,7 +77,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`.
@@ -107,7 +107,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`.
@@ -187,7 +187,7 @@ module Playwright
     # tests. Use [`method: Locator.evaluate`], other `Locator` helper methods or web-first assertions instead.
     #
     # The method finds an element matching the specified selector within the frame and passes it as a first argument to
-    # `expression`. See [Working with selectors](./selectors.md) for more details. If no elements match the selector, the
+    # `expression`. See [Working with selectors](../selectors.md) for more details. If no elements match the selector, the
     # method throws an error.
     #
     # If `expression` returns a [Promise], then [`method: Frame.evalOnSelector`] would wait for the promise to resolve and
@@ -210,7 +210,7 @@ module Playwright
     # better job.
     #
     # The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-    # as a first argument to `expression`. See [Working with selectors](./selectors.md) for more details.
+    # as a first argument to `expression`. See [Working with selectors](../selectors.md) for more details.
     #
     # If `expression` returns a [Promise], then [`method: Frame.evalOnSelectorAll`] would wait for the promise to resolve and
     # return its value.
@@ -288,7 +288,7 @@ module Playwright
       wrap_impl(@impl.evaluate_handle(unwrap_impl(expression), arg: unwrap_impl(arg)))
     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.
     #
@@ -371,7 +371,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`.
@@ -415,28 +415,28 @@ module Playwright
       wrap_impl(@impl.detached?)
     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)))
@@ -499,7 +499,7 @@ module Playwright
     # > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
     #
     # The method finds an element matching the specified selector within the frame. See
-    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns `null`.
+    # [Working with selectors](../selectors.md) for more details. If no elements match the selector, returns `null`.
     def query_selector(selector, strict: nil)
       wrap_impl(@impl.query_selector(unwrap_impl(selector), strict: unwrap_impl(strict)))
     end
@@ -509,12 +509,12 @@ module Playwright
     # > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects instead.
     #
     # The method finds all elements matching the specified selector within the frame. See
-    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns empty array.
+    # [Working with selectors](../selectors.md) for more details. If no elements match the selector, returns empty array.
     def query_selector_all(selector)
       wrap_impl(@impl.query_selector_all(unwrap_impl(selector)))
     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
@@ -550,7 +550,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.
@@ -592,7 +592,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`.
@@ -647,7 +647,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.
@@ -793,12 +793,6 @@ module Playwright
       wrap_impl(@impl.highlight(unwrap_impl(selector)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def once(event, callback)
@@ -811,6 +805,12 @@ module Playwright
       event_emitter_proxy.on(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame_locator.rb

@@ -52,7 +52,7 @@ module Playwright
       wrap_impl(@impl.locator(unwrap_impl(selector), has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
     end
 
-    # Returns locator to the n-th matching frame.
+    # Returns locator to the n-th matching frame. It's zero based, `nth(0)` selects the first frame.
     def nth(index)
       wrap_impl(@impl.nth(unwrap_impl(index)))
     end

data/lib/playwright_api/js_handle.rb

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

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.
@@ -257,7 +257,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.
@@ -295,27 +295,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
@@ -330,7 +330,7 @@ module Playwright
       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
@@ -364,27 +364,29 @@ module Playwright
 
     # Returns the buffer with the captured 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.
     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
@@ -425,7 +427,7 @@ 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.
     def select_text(force: nil, timeout: nil)
       wrap_impl(@impl.select_text(force: unwrap_impl(force), timeout: unwrap_impl(timeout)))
@@ -434,7 +436,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.
@@ -465,7 +467,7 @@ module Playwright
     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 +516,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.