playwright-ruby-client 1.47.0 → 1.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ba01989399fc2a5a939b0471703384bafe37c0dda1e303dfb4f5c187d1e2f32
-  data.tar.gz: 98ab56b3079b654287aa4521b261745892222b699e696f016b90c09258796b1e
+  metadata.gz: d2395db25eb38153f747d215212bc8256364e3b705a1aa674e486e25b75e19f2
+  data.tar.gz: b253eb7836baa12a6a9caebc9a3a96d982d49063324631a4cba6a8fa9a2eaaca
 SHA512:
-  metadata.gz: 24d8ef9d5fb812b46494ebdec1adf2412e7a129368ea1b6e58883e73f028af1b2912e8a14a56e204a5d01c094a75c9e812b2a7df9fc42a3039f736ca267389a9
-  data.tar.gz: fdcd1a66ec8a5db98e094126e3bfde6c0d0c43aae68c56926f8779ebab4d394cb4715f66bb69c7b37e21c0daea4cf1c92723123e9263342b42a6b6721052c52e
+  metadata.gz: e323743b057fbd6c736e78a1c74d9a7f728a998c3f94771b62a58ddd2c203541f0376cd53947e644232f2614d328d9c09165823a0676b5a0a95778afa72eb044
+  data.tar.gz: 67367108051427ecd042eac7d241b5452ccd8b53ee69644eec6700e1b12e1b2899712e88d94808f387d10eeb2dc5512e44d92ea4cfc5b09d5fd6947193c82e19

data/documentation/docs/api/accessibility.md

@@ -25,6 +25,12 @@ assistive technologies themselves. By default, Playwright tries to approximate t
 def snapshot(interestingOnly: nil, root: nil)
 ```
 
+:::warning
+
+This method 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.
+
+:::
+
 
 Captures the current state of the accessibility tree. The returned object represents the root accessible node of the
 page.

data/documentation/docs/api/api_request_context.md

@@ -122,7 +122,7 @@ data = {
 api_request_context.fetch("https://example.com/api/create_book", method: 'post', data: data)
 ```
 
-The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data` encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
+The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data` encoding, by specifiying the `multipart` parameter:
 
 ```ruby
 api_request_context.fetch(

data/documentation/docs/api/browser_context.md

@@ -273,7 +273,7 @@ def route(url, handler, times: nil)
 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**: [BrowserContext#route](./browser_context#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 by setting `Browser.newContext.serviceWorkers` to `'block'`.
+**NOTE**: [BrowserContext#route](./browser_context#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 by setting `serviceWorkers` to `'block'`.
 
 **Usage**
 
@@ -331,7 +331,7 @@ def route_from_har(
 
 If specified the network requests that are made in the context will be served from the HAR file. Read more about [Replaying from HAR](https://playwright.dev/python/docs/mock#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'`.
+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 `serviceWorkers` to `'block'`.
 
 ## service_workers
 

data/documentation/docs/api/element_handle.md

@@ -609,6 +609,12 @@ Returns the `node.textContent`.
 def type(text, delay: nil, noWaitAfter: nil, timeout: nil)
 ```
 
+:::warning
+
+In most cases, you should use [Locator#fill](./locator#fill) instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [Locator#press_sequentially](./locator#press_sequentially).
+
+:::
+
 
 Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
 

data/documentation/docs/api/frame.md

@@ -1032,6 +1032,12 @@ def type(
       timeout: nil)
 ```
 
+:::warning
+
+In most cases, you should use [Locator#fill](./locator#fill) instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [Locator#press_sequentially](./locator#press_sequentially).
+
+:::
+
 
 Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used to
 send fine-grained keyboard events. To fill values in form fields, use [Frame#fill](./frame#fill).
@@ -1126,6 +1132,12 @@ frame.wait_for_load_state # the promise resolves after "load" event.
 def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
 ```
 
+:::warning
+
+This method is inherently racy, please use [Frame#wait_for_url](./frame#wait_for_url) instead.
+
+:::
+
 
 Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the navigation
 will resolve with the response of the last redirect. In case of navigation to a different anchor or navigation due to

data/documentation/docs/api/frame_locator.md

@@ -5,10 +5,10 @@ sidebar_position: 10
 # FrameLocator
 
 
-FrameLocator represents a view to the `iframe` on the page. It captures the logic sufficient to retrieve the `iframe` and locate elements in that iframe. FrameLocator can be created with either [Page#frame_locator](./page#frame_locator) or [Locator#frame_locator](./locator#frame_locator) method.
+FrameLocator represents a view to the `iframe` on the page. It captures the logic sufficient to retrieve the `iframe` and locate elements in that iframe. FrameLocator can be created with either [Locator#content_frame](./locator#content_frame), [Page#frame_locator](./page#frame_locator) or [Locator#frame_locator](./locator#frame_locator) method.
 
 ```ruby
-locator = page.frame_locator("my-frame").get_by_text("Submit")
+locator = page.locator("my-frame").content_frame.get_by_text("Submit")
 locator.click
 ```
 
@@ -18,10 +18,10 @@ Frame locators are strict. This means that all operations on frame locators will
 
 ```ruby
 # Throws if there are several frames in DOM:
-page.frame_locator('.result-frame').get_by_role('button').click
+page.locator('.result-frame').content_frame.get_by_role('button').click
 
 # Works because we explicitly tell locator to pick the first frame:
-page.frame_locator('.result-frame').first.get_by_role('button').click
+page.locator('.result-frame').first.content_frame.get_by_role('button').click
 ```
 
 **Converting Locator to FrameLocator**
@@ -38,6 +38,12 @@ If you have a [FrameLocator](./frame_locator) object it can be converted to [Loc
 def first
 ```
 
+:::warning
+
+Use [Locator#first](./locator#first) followed by [Locator#content_frame](./locator#content_frame) instead.
+
+:::
+
 
 Returns locator to the first matching frame.
 
@@ -278,6 +284,12 @@ page.get_by_title("Issues count").text_content # => "25 issues"
 def last
 ```
 
+:::warning
+
+Use [Locator#last](./locator#last) followed by [Locator#content_frame](./locator#content_frame) instead.
+
+:::
+
 
 Returns locator to the last matching frame.
 
@@ -303,6 +315,12 @@ The method finds an element matching the specified selector in the locator's sub
 def nth(index)
 ```
 
+:::warning
+
+Use [Locator#nth](./locator#nth) followed by [Locator#content_frame](./locator#content_frame) instead.
+
+:::
+
 
 Returns locator to the n-th matching frame. It's zero based, `nth(0)` selects the first frame.
 
@@ -322,7 +340,7 @@ For a reverse operation, use [Locator#content_frame](./locator#content_frame).
 **Usage**
 
 ```ruby
-frame_locator = page.frame_locator('iframe[name="embedded"]')
+frame_locator = page.locator('iframe[name="embedded"]').content_frame
 # ...
 locator = frame_locator.owner
 locator.get_attribute('src') # => frame1.html

data/documentation/docs/api/locator.md

@@ -1016,7 +1016,9 @@ def or(locator)
 ```
 
 
-Creates a locator that matches either of the two locators.
+Creates a locator matching all elements that match one or both of the two locators.
+
+Note that when both locators match something, the resulting locator will have multiple matches and violate [locator strictness](https://playwright.dev/python/docs/locators#strictness) guidelines.
 
 **Usage**
 
@@ -1335,6 +1337,12 @@ Returns the [`node.textContent`](https://developer.mozilla.org/en-US/docs/Web/AP
 def type(text, delay: nil, noWaitAfter: nil, timeout: nil)
 ```
 
+:::warning
+
+In most cases, you should use [Locator#fill](./locator#fill) instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [Locator#press_sequentially](./locator#press_sequentially).
+
+:::
+
 
 Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text.
 

data/documentation/docs/api/page.md

@@ -1038,8 +1038,7 @@ button in the page overlay or to call `playwright.resume()` in the DevTools cons
 User can inspect selectors or perform manual steps while paused. Resume will continue running the original script from
 the place it was paused.
 
-**NOTE**: This method requires Playwright to be started in a headed mode, with a falsy `headless` value in
-the [BrowserType#launch](./browser_type#launch).
+**NOTE**: This method requires Playwright to be started in a headed mode, with a falsy `headless` option.
 
 ## pdf
 
@@ -1202,7 +1201,7 @@ Once routing is enabled, every request matching the url pattern will stall unles
 
 **NOTE**: The handler will only be called for the first url if the response is a redirect.
 
-**NOTE**: [Page#route](./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 by setting `Browser.newContext.serviceWorkers` to `'block'`.
+**NOTE**: [Page#route](./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 by setting `serviceWorkers` to `'block'`.
 
 **NOTE**: [Page#route](./page#route) will not intercept the first request of a popup page. Use [BrowserContext#route](./browser_context#route) instead.
 
@@ -1258,7 +1257,7 @@ def route_from_har(
 
 If specified the network requests that are made in the page will be served from the HAR file. Read more about [Replaying from HAR](https://playwright.dev/python/docs/mock#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'`.
+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 `serviceWorkers` to `'block'`.
 
 ## screenshot
 
@@ -1494,6 +1493,12 @@ def type(
       timeout: nil)
 ```
 
+:::warning
+
+In most cases, you should use [Locator#fill](./locator#fill) instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [Locator#press_sequentially](./locator#press_sequentially).
+
+:::
+
 
 Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `page.type` can be used to send
 fine-grained keyboard events. To fill values in form fields, use [Page#fill](./page#fill).
@@ -1684,6 +1689,12 @@ puts popup.title # popup is ready to use.
 def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
 ```
 
+:::warning
+
+This method is inherently racy, please use [Page#wait_for_url](./page#wait_for_url) instead.
+
+:::
+
 
 Waits for the main frame navigation and returns the main resource response. In case of multiple redirects, the navigation
 will resolve with the response of the last redirect. In case of navigation to a different anchor or navigation due to

data/documentation/docs/include/api_coverage.md

@@ -288,6 +288,7 @@
 * get_by_title
 * go_back
 * go_forward
+* ~~request_gc~~
 * goto
 * hover
 * inner_html
@@ -313,6 +314,7 @@
 * reload
 * route
 * route_from_har
+* ~~route_web_socket~~
 * screenshot
 * select_option
 * set_checked
@@ -375,6 +377,7 @@
 * pages
 * route
 * route_from_har
+* ~~route_web_socket~~
 * service_workers
 * set_default_navigation_timeout
 * set_default_timeout

data/lib/playwright/test.rb

@@ -8,15 +8,15 @@ module Playwright
         @timeout_settings = TimeoutSettings.new
       end
 
-      def call(actual, message = nil)
+      def call(actual, is_not)
         case actual
         when Page
           PageAssertions.new(
             PageAssertionsImpl.new(
               actual,
               @timeout_settings.timeout,
-              false,
-              message,
+              is_not,
+              nil,
             )
           )
         when Locator
@@ -24,8 +24,8 @@ module Playwright
             LocatorAssertionsImpl.new(
               actual,
               @timeout_settings.timeout,
-              false,
-              message,
+              is_not,
+              nil,
             )
           )
         else
@@ -43,7 +43,15 @@ module Playwright
         end
 
         def matches?(actual)
-          Expect.new.call(actual).send(@method, *@args, **@kwargs)
+          Expect.new.call(actual, false).send(@method, *@args, **@kwargs)
+          true
+        rescue AssertionError => e
+          @failure_message = e.full_message
+          false
+        end
+
+        def does_not_match?(actual)
+          Expect.new.call(actual, true).send(@method, *@args, **@kwargs)
           true
         rescue AssertionError => e
           @failure_message = e.full_message
@@ -54,10 +62,8 @@ module Playwright
           @failure_message
         end
 
-        # we have to invert the message again here because RSpec wants to control
-        # its own negation
         def failure_message_when_negated
-          @failure_message.gsub("expected to", "not expected to")
+          @failure_message
         end
       end
     end

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.47.0'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.47.1'
+  VERSION = '1.48.0'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.48.2'
 end

data/lib/playwright_api/accessibility.rb

@@ -48,6 +48,8 @@ module Playwright
     # if node:
     #     print(node["name"])
     # ```
+    #
+    # @deprecated This method 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 snapshot(interestingOnly: nil, root: nil)
       wrap_impl(@impl.snapshot(interestingOnly: unwrap_impl(interestingOnly), root: unwrap_impl(root)))
     end

data/lib/playwright_api/android.rb

@@ -38,12 +38,6 @@ module Playwright
     end
     alias_method :default_timeout=, :set_default_timeout
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -56,6 +50,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/android_device.rb

@@ -203,12 +203,6 @@ module Playwright
       wrap_impl(@impl.tap_on(unwrap_impl(selector), duration: unwrap_impl(duration), timeout: unwrap_impl(timeout)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -221,6 +215,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/api_request_context.rb

@@ -108,7 +108,7 @@ module Playwright
     # api_request_context.fetch("https://example.com/api/createBook", method="post", data=data)
     # ```
     #
-    # The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data` encoding. Use `FormData` to construct request body and pass it to the request as `multipart` parameter:
+    # The common way to send file(s) in the body of a request is to upload them as form fields with `multipart/form-data` encoding, by specifiying the `multipart` parameter:
     #
     # ```python
     # api_request_context.fetch(
@@ -286,12 +286,6 @@ module Playwright
       raise NotImplementedError.new('storage_state is not implemented yet.')
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -304,6 +298,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/browser.rb

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

data/lib/playwright_api/browser_context.rb

@@ -250,7 +250,7 @@ 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: 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 by setting `Browser.newContext.serviceWorkers` to `'block'`.
+    # **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 by setting `serviceWorkers` to `'block'`.
     #
     # **Usage**
     #
@@ -300,7 +300,7 @@ module Playwright
     #
     # If specified the network requests that are made in the context will be served from the HAR file. Read more about [Replaying from HAR](../mock.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'`.
+    # 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 `serviceWorkers` to `'block'`.
     def route_from_har(
           har,
           notFound: nil,
@@ -311,6 +311,32 @@ module Playwright
       wrap_impl(@impl.route_from_har(unwrap_impl(har), notFound: unwrap_impl(notFound), update: unwrap_impl(update), updateContent: unwrap_impl(updateContent), updateMode: unwrap_impl(updateMode), url: unwrap_impl(url)))
     end
 
+    #
+    # This method allows to modify websocket connections that are made by any page in the browser context.
+    #
+    # Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this method before creating any pages.
+    #
+    # **Usage**
+    #
+    # Below is an example of a simple handler that blocks some websocket messages.
+    # See `WebSocketRoute` for more details and examples.
+    #
+    # ```python sync
+    # def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+    #   if message == "to-be-blocked":
+    #     return
+    #   ws.send(message)
+    #
+    # def handler(ws: WebSocketRoute):
+    #   ws.route_send(lambda message: message_handler(ws, message))
+    #   ws.connect()
+    #
+    # context.route_web_socket("/ws", handler)
+    # ```
+    def route_web_socket(url, handler)
+      raise NotImplementedError.new('route_web_socket is not implemented yet.')
+    end
+
     #
     # **NOTE**: Service workers are only supported on Chromium-based browsers.
     #
@@ -462,12 +488,6 @@ module Playwright
       wrap_impl(@impl.browser=(unwrap_impl(req)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -480,6 +500,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/browser_type.rb

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

data/lib/playwright_api/cdp_session.rb

@@ -31,12 +31,6 @@ module Playwright
       wrap_impl(@impl.send_message(unwrap_impl(method), params: unwrap_impl(params)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -49,6 +43,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/dialog.rb

@@ -68,12 +68,6 @@ module Playwright
       wrap_impl(@impl.accept_async(promptText: unwrap_impl(promptText)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -86,6 +80,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/element_handle.rb

@@ -505,6 +505,8 @@ module Playwright
     # To press a special key, like `Control` or `ArrowDown`, use [`method: ElementHandle.press`].
     #
     # **Usage**
+    #
+    # @deprecated In most cases, you should use [`method: Locator.fill`] instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [`method: Locator.pressSequentially`].
     def type(text, delay: nil, noWaitAfter: nil, timeout: nil)
       wrap_impl(@impl.type(unwrap_impl(text), delay: unwrap_impl(delay), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
@@ -570,12 +572,6 @@ module Playwright
       wrap_impl(@impl.wait_for_selector(unwrap_impl(selector), state: unwrap_impl(state), strict: unwrap_impl(strict), timeout: unwrap_impl(timeout)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -588,6 +584,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame.rb

@@ -866,6 +866,8 @@ module Playwright
     # To press a special key, like `Control` or `ArrowDown`, use [`method: Keyboard.press`].
     #
     # **Usage**
+    #
+    # @deprecated In most cases, you should use [`method: Locator.fill`] instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [`method: Locator.pressSequentially`].
     def type(
           selector,
           text,
@@ -972,6 +974,8 @@ module Playwright
     #
     # **NOTE**: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is considered
     # a navigation.
+    #
+    # @deprecated This method is inherently racy, please use [`method: Frame.waitForURL`] instead.
     def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
       wrap_impl(@impl.expect_navigation(timeout: unwrap_impl(timeout), url: unwrap_impl(url), waitUntil: unwrap_impl(waitUntil), &wrap_block_call(block)))
     end
@@ -1044,12 +1048,6 @@ module Playwright
       wrap_impl(@impl.highlight(unwrap_impl(selector)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -1062,6 +1060,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/frame_locator.rb

@@ -1,9 +1,9 @@
 module Playwright
   #
-  # FrameLocator represents a view to the `iframe` on the page. It captures the logic sufficient to retrieve the `iframe` and locate elements in that iframe. FrameLocator can be created with either [`method: Page.frameLocator`] or [`method: Locator.frameLocator`] method.
+  # FrameLocator represents a view to the `iframe` on the page. It captures the logic sufficient to retrieve the `iframe` and locate elements in that iframe. FrameLocator can be created with either [`method: Locator.contentFrame`], [`method: Page.frameLocator`] or [`method: Locator.frameLocator`] method.
   #
   # ```python sync
-  # locator = page.frame_locator("my-frame").get_by_text("Submit")
+  # locator = page.locator("my-frame").content_frame.get_by_text("Submit")
   # locator.click()
   # ```
   #
@@ -13,10 +13,10 @@ module Playwright
   #
   # ```python sync
   # # Throws if there are several frames in DOM:
-  # page.frame_locator('.result-frame').get_by_role('button').click()
+  # page.locator('.result-frame').content_frame.get_by_role('button').click()
   #
   # # Works because we explicitly tell locator to pick the first frame:
-  # page.frame_locator('.result-frame').first.get_by_role('button').click()
+  # page.locator('.result-frame').first.content_frame.get_by_role('button').click()
   # ```
   #
   # **Converting Locator to FrameLocator**
@@ -30,6 +30,8 @@ module Playwright
 
     #
     # Returns locator to the first matching frame.
+    #
+    # @deprecated Use [`method: Locator.first`] followed by [`method: Locator.contentFrame`] instead.
     def first
       wrap_impl(@impl.first)
     end
@@ -233,6 +235,8 @@ module Playwright
 
     #
     # Returns locator to the last matching frame.
+    #
+    # @deprecated Use [`method: Locator.last`] followed by [`method: Locator.contentFrame`] instead.
     def last
       wrap_impl(@impl.last)
     end
@@ -252,6 +256,8 @@ module Playwright
 
     #
     # Returns locator to the n-th matching frame. It's zero based, `nth(0)` selects the first frame.
+    #
+    # @deprecated Use [`method: Locator.nth`] followed by [`method: Locator.contentFrame`] instead.
     def nth(index)
       wrap_impl(@impl.nth(unwrap_impl(index)))
     end
@@ -266,7 +272,7 @@ module Playwright
     # **Usage**
     #
     # ```python sync
-    # frame_locator = page.frame_locator("iframe[name=\"embedded\"]")
+    # frame_locator = page.locator("iframe[name=\"embedded\"]").content_frame
     # # ...
     # locator = frame_locator.owner
     # expect(locator).to_be_visible()

data/lib/playwright_api/js_handle.rb

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

data/lib/playwright_api/locator.rb

@@ -854,7 +854,9 @@ module Playwright
     end
 
     #
-    # Creates a locator that matches either of the two locators.
+    # Creates a locator matching all elements that match one or both of the two locators.
+    #
+    # Note that when both locators match something, the resulting locator will have multiple matches and violate [locator strictness](../locators.md#strictness) guidelines.
     #
     # **Usage**
     #
@@ -1148,6 +1150,8 @@ module Playwright
     # To press a special key, like `Control` or `ArrowDown`, use [`method: Locator.press`].
     #
     # **Usage**
+    #
+    # @deprecated In most cases, you should use [`method: Locator.fill`] instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [`method: Locator.pressSequentially`].
     def type(text, delay: nil, noWaitAfter: nil, timeout: nil)
       wrap_impl(@impl.type(unwrap_impl(text), delay: unwrap_impl(delay), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end

data/lib/playwright_api/page.rb

@@ -793,6 +793,23 @@ module Playwright
       wrap_impl(@impl.go_forward(timeout: unwrap_impl(timeout), waitUntil: unwrap_impl(waitUntil)))
     end
 
+    #
+    # Request the page to perform garbage collection. Note that there is no guarantee that all unreachable objects will be collected.
+    #
+    # This is useful to help detect memory leaks. For example, if your page has a large object `'suspect'` that might be leaked, you can check that it does not leak by using a [`WeakRef`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef).
+    #
+    # ```python sync
+    # # 1. In your page, save a WeakRef for the "suspect".
+    # page.evaluate("globalThis.suspectWeakRef = new WeakRef(suspect)")
+    # # 2. Request garbage collection.
+    # page.request_gc()
+    # # 3. Check that weak ref does not deref to the original object.
+    # assert page.evaluate("!globalThis.suspectWeakRef.deref()")
+    # ```
+    def request_gc
+      raise NotImplementedError.new('request_gc is not implemented yet.')
+    end
+
     #
     # Returns the main resource response. In case of multiple redirects, the navigation will resolve with the first
     # non-redirect response.
@@ -933,8 +950,7 @@ module Playwright
     # User can inspect selectors or perform manual steps while paused. Resume will continue running the original script from
     # the place it was paused.
     #
-    # **NOTE**: This method requires Playwright to be started in a headed mode, with a falsy `headless` value in
-    # the [`method: BrowserType.launch`].
+    # **NOTE**: This method requires Playwright to be started in a headed mode, with a falsy `headless` option.
     def pause
       wrap_impl(@impl.pause)
     end
@@ -1079,11 +1095,9 @@ module Playwright
     # - You can register multiple handlers. However, only a single handler will be running at a time. Make sure the actions within a handler don't depend on another handler.
     #
     # **NOTE**: Running the handler will alter your page state mid-test. For example it will change the currently focused element and move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on the focus and mouse state being unchanged.
-    # <br />
-    # <br />
+    #
     # For example, consider a test that calls [`method: Locator.focus`] followed by [`method: Keyboard.press`]. If your handler clicks a button between these two actions, the focused element most likely will be wrong, and key press will happen on the unexpected element. Use [`method: Locator.press`] instead to avoid this problem.
-    # <br />
-    # <br />
+    #
     # Another example is a series of mouse actions, where [`method: Mouse.move`] is followed by [`method: Mouse.down`]. Again, when the handler runs between these two actions, the mouse position will be wrong during the mouse down. Prefer self-contained actions like [`method: Locator.click`] that do not rely on the state being unchanged by a handler.
     #
     # **Usage**
@@ -1159,7 +1173,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 by setting `Browser.newContext.serviceWorkers` to `'block'`.
+    # **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 by setting `serviceWorkers` to `'block'`.
     #
     # **NOTE**: [`method: Page.route`] will not intercept the first request of a popup page. Use [`method: BrowserContext.route`] instead.
     #
@@ -1207,7 +1221,7 @@ module Playwright
     #
     # If specified the network requests that are made in the page will be served from the HAR file. Read more about [Replaying from HAR](../mock.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'`.
+    # 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 `serviceWorkers` to `'block'`.
     def route_from_har(
           har,
           notFound: nil,
@@ -1218,6 +1232,29 @@ module Playwright
       wrap_impl(@impl.route_from_har(unwrap_impl(har), notFound: unwrap_impl(notFound), update: unwrap_impl(update), updateContent: unwrap_impl(updateContent), updateMode: unwrap_impl(updateMode), url: unwrap_impl(url)))
     end
 
+    #
+    # This method allows to modify websocket connections that are made by the page.
+    #
+    # Note that only `WebSocket`s created after this method was called will be routed. It is recommended to call this method before navigating the page.
+    #
+    # **Usage**
+    #
+    # Below is an example of a simple mock that responds to a single message. See `WebSocketRoute` for more details and examples.
+    #
+    # ```python sync
+    # def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
+    #   if message == "request":
+    #     ws.send("response")
+    #
+    # def handler(ws: WebSocketRoute):
+    #   ws.on_message(lambda message: message_handler(ws, message))
+    #
+    # page.route_web_socket("/ws", handler)
+    # ```
+    def route_web_socket(url, handler)
+      raise NotImplementedError.new('route_web_socket is not implemented yet.')
+    end
+
     #
     # Returns the buffer with the captured screenshot.
     def screenshot(
@@ -1412,6 +1449,8 @@ module Playwright
     # To press a special key, like `Control` or `ArrowDown`, use [`method: Keyboard.press`].
     #
     # **Usage**
+    #
+    # @deprecated In most cases, you should use [`method: Locator.fill`] instead. You only need to press keys one by one if there is special keyboard handling on the page - in this case use [`method: Locator.pressSequentially`].
     def type(
           selector,
           text,
@@ -1589,6 +1628,8 @@ module Playwright
     #
     # **NOTE**: Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is considered
     # a navigation.
+    #
+    # @deprecated This method is inherently racy, please use [`method: Page.waitForURL`] instead.
     def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
       wrap_impl(@impl.expect_navigation(timeout: unwrap_impl(timeout), url: unwrap_impl(url), waitUntil: unwrap_impl(waitUntil), &wrap_block_call(block)))
     end
@@ -1779,12 +1820,6 @@ module Playwright
       wrap_impl(@impl.owned_context=(unwrap_impl(req)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -1797,6 +1832,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/playwright.rb

@@ -93,20 +93,14 @@ module Playwright
       raise NotImplementedError.new('stop is not implemented yet.')
     end
 
-    # @nodoc
-    def electron
-      wrap_impl(@impl.electron)
-    end
-
     # @nodoc
     def android
       wrap_impl(@impl.android)
     end
 
-    # -- inherited from EventEmitter --
     # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
+    def electron
+      wrap_impl(@impl.electron)
     end
 
     # -- inherited from EventEmitter --
@@ -121,6 +115,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/request.rb

@@ -205,12 +205,6 @@ module Playwright
       wrap_impl(@impl.header_values(unwrap_impl(name)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -223,6 +217,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/response.rb

@@ -127,12 +127,6 @@ module Playwright
       wrap_impl(@impl.from_service_worker?)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -145,6 +139,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/route.rb

@@ -172,12 +172,6 @@ module Playwright
       wrap_impl(@impl.redirect_navigation_request(unwrap_impl(url)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -190,6 +184,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/selectors.rb

@@ -61,12 +61,6 @@ module Playwright
       wrap_impl(@impl.text_id_attribute=(unwrap_impl(attribute_name)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -79,6 +73,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/tracing.rb

@@ -70,12 +70,6 @@ module Playwright
       wrap_impl(@impl.stop_chunk(path: unwrap_impl(path)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -88,6 +82,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/web_socket.rb

@@ -32,12 +32,6 @@ module Playwright
       wrap_impl(@impl.wait_for_event(unwrap_impl(event), predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -50,6 +44,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/worker.rb

@@ -56,12 +56,6 @@ module Playwright
       wrap_impl(@impl.page=(unwrap_impl(req)))
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def once(event, callback)
-      event_emitter_proxy.once(event, callback)
-    end
-
     # -- inherited from EventEmitter --
     # @nodoc
     def on(event, callback)
@@ -74,6 +68,12 @@ module Playwright
       event_emitter_proxy.off(event, callback)
     end
 
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      event_emitter_proxy.once(event, callback)
+    end
+
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: playwright-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.47.0
+  version: 1.48.0
 platform: ruby
 authors:
 - YusukeIwaki
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-09-14 00:00:00.000000000 Z
+date: 2024-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -413,5 +413,5 @@ requirements: []
 rubygems_version: 3.3.27
 signing_key: 
 specification_version: 4
-summary: The Ruby binding of playwright driver 1.47.1
+summary: The Ruby binding of playwright driver 1.48.2
 test_files: []