playwright-ruby-client 1.22.0 → 1.25.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 explicitly 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)

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)
@@ -372,13 +382,13 @@ module Playwright
     end
 
     # @nodoc
-    def options=(req)
-      wrap_impl(@impl.options=(unwrap_impl(req)))
+    def pause
+      wrap_impl(@impl.pause)
     end
 
     # @nodoc
-    def pause
-      wrap_impl(@impl.pause)
+    def options=(req)
+      wrap_impl(@impl.options=(unwrap_impl(req)))
     end
 
     # @nodoc

data/lib/playwright_api/browser_type.rb

@@ -18,7 +18,9 @@ module Playwright
   # ```
   class BrowserType < PlaywrightApi
 
-    # This method attaches Playwright to an existing browser instance.
+    # This method attaches Playwright to an existing browser instance. When connecting to another browser launched via
+    # `BrowserType.launchServer` in Node.js, the major and minor version needs to match the client version (1.2.3 → is
+    # compatible with 1.2.x).
     def connect(wsEndpoint, headers: nil, slowMo: nil, timeout: nil)
       raise NotImplementedError.new('connect is not implemented yet.')
     end
@@ -124,12 +126,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 +144,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'`.

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.
     #
@@ -394,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,

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")
   # ```

data/lib/playwright_api/locator.rb

@@ -18,7 +18,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.
     #
@@ -224,7 +224,17 @@ module Playwright
       wrap_impl(@impl.fill(unwrap_impl(value), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
-    # This method narrows existing locator according to the options, for example filters by text.
+    # This method narrows existing locator according to the options, for example filters by text. It can be chained to filter
+    # multiple times.
+    #
+    # ```python sync
+    # row_locator = page.locator("tr")
+    # # ...
+    # row_locator
+    #     .filter(has_text="text in column 1")
+    #     .filter(has=page.locator("tr", has_text="column 2 button"))
+    #     .screenshot()
+    # ```
     def filter(has: nil, hasText: nil)
       wrap_impl(@impl.filter(has: unwrap_impl(has), hasText: unwrap_impl(hasText)))
     end
@@ -254,6 +264,7 @@ module Playwright
     def get_attribute(name, timeout: nil)
       wrap_impl(@impl.get_attribute(unwrap_impl(name), timeout: unwrap_impl(timeout)))
     end
+    alias_method :[], :get_attribute
 
     # Highlight the corresponding element(s) on the screen. Useful for debugging, don't commit the code that uses
     # [`method: Locator.highlight`].
@@ -418,17 +429,6 @@ module Playwright
     # # multiple selection
     # element.select_option(value=["red", "green", "blue"])
     # ```
-    #
-    # ```python sync
-    # # single selection matching the value
-    # element.select_option("blue")
-    # # single selection matching both the value and the label
-    # element.select_option(label="blue")
-    # # multiple selection
-    # element.select_option("red", "green", "blue")
-    # # multiple selection for blue, red and second option
-    # element.select_option(value="blue", { index: 2 }, "red")
-    # ```
     def select_option(
           element: nil,
           index: nil,

data/lib/playwright_api/page.rb

@@ -44,6 +44,9 @@ module Playwright
   # ```
   class Page < PlaywrightApi
 
+    # **DEPRECATED** This property is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you
+    # need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for
+    # integration with Axe.
     def accessibility # property
       wrap_impl(@impl.accessibility)
     end
@@ -853,7 +856,7 @@ module Playwright
     # > NOTE: The handler will only be called for the first url if the response is a redirect.
     # > NOTE: [`method: Page.route`] will not intercept requests intercepted by Service Worker. See
     # [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
-    # request interception. Via `await context.addInitScript(() => delete window.navigator.serviceWorker);`
+    # request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
     #
     # An example of a naive handler that aborts all image requests:
     #
@@ -895,6 +898,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 page will be served from the HAR file. Read more about
+    # [Replaying from HAR](../network.md#replaying-from-har).
+    #
+    # Playwright will not serve requests intercepted by Service Worker from the HAR file. See
+    # [this](https://github.com/microsoft/playwright/issues/1090) issue. We recommend disabling Service Workers when using
+    # request interception by setting `Browser.newContext.serviceWorkers` to `'block'`.
+    def route_from_har(har, notFound: nil, update: nil, url: nil)
+      wrap_impl(@impl.route_from_har(unwrap_impl(har), notFound: unwrap_impl(notFound), update: unwrap_impl(update), url: unwrap_impl(url)))
+    end
+
     # Returns the buffer with the captured screenshot.
     def screenshot(
           animations: nil,
@@ -1399,6 +1412,11 @@ module Playwright
       wrap_impl(@impl.owned_context=(unwrap_impl(req)))
     end
 
+    # @nodoc
+    def guid
+      wrap_impl(@impl.guid)
+    end
+
     # @nodoc
     def start_js_coverage(resetOnNavigation: nil, reportAnonymousScripts: nil)
       wrap_impl(@impl.start_js_coverage(resetOnNavigation: unwrap_impl(resetOnNavigation), reportAnonymousScripts: unwrap_impl(reportAnonymousScripts)))
@@ -1419,11 +1437,6 @@ module Playwright
       wrap_impl(@impl.stop_css_coverage)
     end
 
-    # @nodoc
-    def guid
-      wrap_impl(@impl.guid)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def off(event, callback)

data/lib/playwright_api/request.rb

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

data/lib/playwright_api/response.rb

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

data/lib/playwright_api/route.rb

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

data/lib/playwright_api/selectors.rb

@@ -30,7 +30,7 @@ module Playwright
     #     # Use the selector prefixed with its name.
     #     button = page.locator('tag=button')
     #     # Combine it with other selector engines.
-    #     page.click('tag=div >> text="Click me"')
+    #     page.locator('tag=div >> text="Click me"').click()
     #     # Can use it in any methods supporting selectors.
     #     button_count = page.locator('tag=button').count()
     #     print(button_count)

data/lib/playwright_api/tracing.rb

@@ -41,7 +41,7 @@ module Playwright
     # page.goto("https://playwright.dev")
     #
     # context.tracing.start_chunk()
-    # page.click("text=Get Started")
+    # page.locator("text=Get Started").click()
     # # Everything between start_chunk and stop_chunk will be recorded in the trace.
     # context.tracing.stop_chunk(path = "trace1.zip")
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.25.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-05-18 00:00:00.000000000 Z
+date: 2022-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -316,10 +316,12 @@ files:
 - lib/playwright/events.rb
 - lib/playwright/file_chooser_impl.rb
 - lib/playwright/frame_locator_impl.rb
+- lib/playwright/har_router.rb
 - lib/playwright/http_headers.rb
 - lib/playwright/input_files.rb
 - lib/playwright/javascript.rb
 - lib/playwright/javascript/expression.rb
+- lib/playwright/javascript/regex.rb
 - lib/playwright/javascript/value_parser.rb
 - lib/playwright/javascript/value_serializer.rb
 - lib/playwright/javascript/visitor_info.rb
@@ -362,7 +364,6 @@ files:
 - lib/playwright_api/frame_locator.rb
 - lib/playwright_api/js_handle.rb
 - lib/playwright_api/keyboard.rb
-- lib/playwright_api/local_utils.rb
 - lib/playwright_api/locator.rb
 - lib/playwright_api/mouse.rb
 - lib/playwright_api/page.rb
@@ -398,5 +399,5 @@ requirements: []
 rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver 1.22.1
+summary: The Ruby binding of playwright driver 1.25.0
 test_files: []

data/lib/playwright_api/local_utils.rb

@@ -1,9 +0,0 @@
-module Playwright
-  class LocalUtils < PlaywrightApi
-
-    # @nodoc
-    def zip(zip_file, name_value_array)
-      wrap_impl(@impl.zip(unwrap_impl(zip_file), unwrap_impl(name_value_array)))
-    end
-  end
-end