playwright-ruby-client 1.21.0 → 1.24.0

data/lib/playwright_api/browser.rb

@@ -18,12 +18,21 @@ module Playwright
   # ```
   class Browser < PlaywrightApi
 
+    # Get the browser type (chromium, firefox or webkit) that the browser belongs to.
+    def browser_type
+      wrap_impl(@impl.browser_type)
+    end
+
     # In case this browser is obtained using [`method: BrowserType.launch`], closes the browser and all of its pages (if any
     # were opened).
     #
     # In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the
     # browser server.
     #
+    # > NOTE: This is similar to force quitting the browser. Therefore, you should call [`method: BrowserContext.close`] on
+    # any `BrowserContext`'s you explicitly created earlier with [`method: Browser.newContext`] **before** calling
+    # [`method: Browser.close`].
+    #
     # The `Browser` object itself is considered to be disposed and cannot be used anymore.
     def close
       wrap_impl(@impl.close)
@@ -55,6 +64,11 @@ module Playwright
 
     # Creates a new browser context. It won't share cookies/cache with other browser contexts.
     #
+    # > NOTE: If directly using this method to create `BrowserContext`s, it is best practice to explicilty close the returned
+    # context via [`method: BrowserContext.close`] when your code is done with the `BrowserContext`, and before calling
+    # [`method: Browser.close`]. This will ensure the `context` is closed gracefully and any artifacts—like HARs and
+    # videos—are fully flushed and saved.
+    #
     # ```python sync
     # browser = playwright.firefox.launch() # or "chromium" or "webkit".
     # # create a new incognito browser context.
@@ -62,6 +76,10 @@ module Playwright
     # # create a new page in a pristine context.
     # page = context.new_page()
     # page.goto("https://example.com")
+    #
+    # # gracefully close up everything
+    # context.close()
+    # browser.close()
     # ```
     def new_context(
           acceptDownloads: nil,
@@ -82,19 +100,23 @@ module Playwright
           offline: nil,
           permissions: nil,
           proxy: nil,
+          record_har_content: nil,
+          record_har_mode: nil,
           record_har_omit_content: nil,
           record_har_path: nil,
+          record_har_url_filter: nil,
           record_video_dir: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
+          serviceWorkers: nil,
           storageState: nil,
           strictSelectors: nil,
           timezoneId: nil,
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Creates a new page in a new browser context. Closing this page will close the context as well.
@@ -121,19 +143,23 @@ module Playwright
           offline: nil,
           permissions: nil,
           proxy: nil,
+          record_har_content: nil,
+          record_har_mode: nil,
           record_har_omit_content: nil,
           record_har_path: nil,
+          record_har_url_filter: nil,
           record_video_dir: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
+          serviceWorkers: nil,
           storageState: nil,
           strictSelectors: nil,
           timezoneId: nil,
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), storageState: unwrap_impl(storageState), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # > NOTE: This API controls [Chromium Tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool)
@@ -168,20 +194,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_context.rb

@@ -131,7 +131,7 @@ module Playwright
     #     <button onclick="onClick()">Click me</button>
     #     <div></div>
     #     """)
-    #     page.click("button")
+    #     page.locator("button").click()
     #
     # with sync_playwright() as playwright:
     #     run(playwright)
@@ -190,7 +190,7 @@ module Playwright
     #         <button onclick="onClick()">Click me</button>
     #         <div></div>
     #     """)
-    #     page.click("button")
+    #     page.locator("button").click()
     #
     # with sync_playwright() as playwright:
     #     run(playwright)
@@ -225,9 +225,9 @@ module Playwright
     # Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
     # is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
     #
-    # > NOTE: [`method: Page.route`] will not intercept requests intercepted by Service Worker. See
+    # > NOTE: [`method: BrowserContext.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:
     #
@@ -273,6 +273,16 @@ 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 context 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
+
     # > NOTE: Service workers are only supported on Chromium-based browsers.
     #
     # All existing service workers in the context.
@@ -348,7 +358,7 @@ module Playwright
     #
     # ```python sync
     # with context.expect_event("page") as event_info:
-    #     page.click("button")
+    #     page.locator("button").click()
     # page = event_info.value
     # ```
     def expect_event(event, predicate: nil, timeout: nil, &block)
@@ -398,20 +408,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_type.rb

@@ -124,12 +124,16 @@ module Playwright
           offline: nil,
           permissions: nil,
           proxy: nil,
+          record_har_content: nil,
+          record_har_mode: nil,
           record_har_omit_content: nil,
           record_har_path: nil,
+          record_har_url_filter: nil,
           record_video_dir: nil,
           record_video_size: nil,
           reducedMotion: nil,
           screen: nil,
+          serviceWorkers: nil,
           slowMo: nil,
           strictSelectors: nil,
           timeout: nil,
@@ -138,7 +142,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), slowMo: unwrap_impl(slowMo), strictSelectors: unwrap_impl(strictSelectors), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.launch_persistent_context(unwrap_impl(userDataDir), acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), forcedColors: unwrap_impl(forcedColors), geolocation: unwrap_impl(geolocation), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), hasTouch: unwrap_impl(hasTouch), headless: unwrap_impl(headless), httpCredentials: unwrap_impl(httpCredentials), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), noViewport: unwrap_impl(noViewport), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), record_har_content: unwrap_impl(record_har_content), record_har_mode: unwrap_impl(record_har_mode), record_har_omit_content: unwrap_impl(record_har_omit_content), record_har_path: unwrap_impl(record_har_path), record_har_url_filter: unwrap_impl(record_har_url_filter), record_video_dir: unwrap_impl(record_video_dir), record_video_size: unwrap_impl(record_video_size), reducedMotion: unwrap_impl(reducedMotion), screen: unwrap_impl(screen), serviceWorkers: unwrap_impl(serviceWorkers), slowMo: unwrap_impl(slowMo), strictSelectors: unwrap_impl(strictSelectors), timeout: unwrap_impl(timeout), timezoneId: unwrap_impl(timezoneId), tracesDir: unwrap_impl(tracesDir), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Returns browser name. For example: `'chromium'`, `'webkit'` or `'firefox'`.
@@ -148,20 +152,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/cdp_session.rb

@@ -35,20 +35,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/console_message.rb

@@ -44,20 +44,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/dialog.rb

@@ -60,20 +60,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/download.rb

@@ -7,7 +7,7 @@ module Playwright
   #
   # ```python sync
   # with page.expect_download() as download_info:
-  #     page.click("a")
+  #     page.locator("a").click()
   # download = download_info.value
   # # wait for download to complete
   # path = download.path()

data/lib/playwright_api/element_handle.rb

@@ -45,7 +45,7 @@ module Playwright
     # This method returns the bounding box of the element, or `null` if the element is not visible. The bounding box is
     # calculated relative to the main frame viewport - which is usually the same as the browser window.
     #
-    # Scrolling affects the returned bonding box, similarly to
+    # Scrolling affects the returned bounding box, similarly to
     # [Element.getBoundingClientRect](https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect). That
     # means `x` and/or `y` may be negative.
     #
@@ -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
@@ -341,10 +344,14 @@ module Playwright
       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
     # 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,
@@ -387,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,
@@ -411,6 +407,10 @@ module Playwright
 
     # 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
@@ -438,11 +438,13 @@ 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
@@ -557,20 +559,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/file_chooser.rb

@@ -3,7 +3,7 @@ module Playwright
   #
   # ```python sync
   # with page.expect_file_chooser() as fc_info:
-  #     page.click("upload")
+  #     page.locator("upload").click()
   # file_chooser = fc_info.value
   # file_chooser.set_files("myfile.pdf")
   # ```
@@ -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

@@ -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
@@ -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
@@ -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,
@@ -795,20 +802,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy

data/lib/playwright_api/js_handle.rb

@@ -90,20 +90,20 @@ module Playwright
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def off(event, callback)
+      event_emitter_proxy.off(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
     end
 
     # -- inherited from EventEmitter --
     # @nodoc
-    def off(event, callback)
-      event_emitter_proxy.off(event, callback)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     private def event_emitter_proxy