playwright-ruby-client 1.20.2 → 1.23.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.
@@ -267,7 +267,10 @@ module Playwright
       wrap_impl(@impl.inner_text)
     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
@@ -277,27 +280,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 +333,39 @@ 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 captures a screenshot of the page, clipped to the size and position of this particular element. 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`.
     #
@@ -366,7 +375,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
@@ -385,17 +394,6 @@ module Playwright
     # # multiple selection
     # handle.select_option(value=["red", "green", "blue"])
     # ```
-    #
-    # ```python sync
-    # # single selection matching the value
-    # handle.select_option("blue")
-    # # single selection matching both the value and the label
-    # handle.select_option(label="blue")
-    # # multiple selection
-    # handle.select_option("red", "green", "blue")
-    # # multiple selection for blue, red and second option
-    # handle.select_option(value="blue", { index: 2 }, "red")
-    # ```
     def select_option(
           element: nil,
           index: nil,
@@ -407,8 +405,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
@@ -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.
@@ -436,18 +438,20 @@ module Playwright
     end
     alias_method :checked=, :set_checked
 
-    # This method expects `elementHandle` 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 `ElementHandle` 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.
@@ -496,7 +500,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 +521,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)

data/lib/playwright_api/file_chooser.rb

@@ -25,7 +25,7 @@ module Playwright
     end
 
     # Sets the value of the file input this chooser is associated with. 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.
+    # they are resolved relative to the current working directory. For empty array, clears the selected files.
     def set_files(files, noWaitAfter: nil, timeout: nil)
       wrap_impl(@impl.set_files(unwrap_impl(files), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     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`.
@@ -400,7 +400,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
@@ -415,28 +418,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)))
@@ -445,6 +448,8 @@ module Playwright
     # The method returns an element locator that can be used to perform actions in the frame. Locator is resolved to the
     # 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).
     def locator(selector, has: nil, hasText: nil)
       wrap_impl(@impl.locator(unwrap_impl(selector), has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
     end
@@ -499,7 +504,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 +514,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 +555,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.
@@ -576,11 +581,13 @@ module Playwright
     end
     alias_method :content=, :set_content
 
-    # 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,
@@ -592,7 +599,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 +654,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.

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