playwright-ruby-client 1.49.1 → 1.50.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb8b0e304afaec4e361b4ac3c267890121a4fa7723356cccf6e853d22f3482a1
-  data.tar.gz: 2323dde24b24615d52b3b25d075e62036853877cc1d820b4a4d1da9df1059130
+  metadata.gz: 1987004c514d458f26c9d9860c2571b749cc92479586e2fd2cdc06758a35af5c
+  data.tar.gz: 6d74956b9f6a425ec5c5220e4e22c4ec1ead12d15147d25d4f1f1a55886df546
 SHA512:
-  metadata.gz: 1a1e69cd3f9a84a1e9599eab785e6232c96c5babd98d14f7ff53305eafa3d7487622988f034f9df9632a642c46b1ea0ffbbc6084a3f33f74ea4ef823b3654c8a
-  data.tar.gz: c9bfa47bf0be03755aa6df0b01c1c12e23ca8a402a48be1de3eeaa3fd37edf6f5500feadc0e8abde2f71d835c21fc91b965f28157beb5a5d7669e3da063939b7
+  metadata.gz: 16dc2df9e5b70a8850f5e9eb651e2e0e832d1131e403bd9912811675c407f943f50c97f15872a3c6ef141fae0ec95c61dce7a1168222b38c80cd5176b7438a41
+  data.tar.gz: 40d560d9faf16aec2a91f514a61ef8b229c7895da320bacd1fccddad27f4465471a57269fb9d084a31ea1827463da112fadf43151c6afc03f0564e8e98b2d0b9

data/documentation/docs/api/browser.md

@@ -40,7 +40,7 @@ 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 [BrowserContext#close](./browser_context#close) on any [BrowserContext](./browser_context)'s you explicitly created earlier with [Browser#new_context](./browser#new_context) **before** calling [Browser#close](./browser#close).
+**NOTE**: This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close events, call [BrowserContext#close](./browser_context#close) on any [BrowserContext](./browser_context) instances you explicitly created earlier using [Browser#new_context](./browser#new_context) **before** calling [Browser#close](./browser#close).
 
 The [Browser](./browser) object itself is considered to be disposed and cannot be used anymore.
 

data/documentation/docs/api/browser_type.md

@@ -37,6 +37,8 @@ The default browser context is accessible via [Browser#contexts](./browser#conte
 
 **NOTE**: Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
 
+**NOTE**: This connection is significantly lower fidelity than the Playwright protocol connection via [BrowserType#connect](./browser_type#connect). If you are experiencing issues or attempting to use advanced functionality, you probably want to use [BrowserType#connect](./browser_type#connect).
+
 **Usage**
 
 ```ruby

data/documentation/docs/api/clock.md

@@ -85,6 +85,16 @@ page.clock.pause_at(Time.parse("2020-02-02"))
 page.clock.pause_at("2020-02-02")
 ```
 
+For best results, install the clock before navigating the page and set it to a time slightly before the intended test time. This ensures that all timers run normally during page loading, preventing the page from getting stuck. Once the page has fully loaded, you can safely use [Clock#pause_at](./clock#pause_at) to pause the clock.
+
+```ruby
+# Initialize clock with some time before the test time and let the page load
+# naturally. `Date.now` will progress as the timers fire.
+page.clock.install(Time.parse("2024-12-10T08:00:00Z"))
+page.goto("http://localhost:3333")
+page.clock.pause_at(Time.parse("2024-12-10T10:00:00Z"))
+```
+
 ## resume
 
 ```

data/documentation/docs/api/element_handle.md

@@ -192,7 +192,6 @@ properties:
 You can also specify [JSHandle](./js_handle) as the property value if you want live objects to be passed into the event:
 
 ```ruby
-# note you can only create data_transfer in chromium and firefox
 data_transfer = page.evaluate_handle("new DataTransfer()")
 element_handle.dispatch_event("dragstart", eventInit: { dataTransfer: data_transfer })
 ```

data/documentation/docs/api/experimental/android_device.md

@@ -34,7 +34,6 @@ def launch_browser(
       baseURL: nil,
       bypassCSP: nil,
       colorScheme: nil,
-      command: nil,
       deviceScaleFactor: nil,
       extraHTTPHeaders: nil,
       forcedColors: nil,
@@ -48,6 +47,7 @@ def launch_browser(
       noViewport: nil,
       offline: nil,
       permissions: nil,
+      pkg: nil,
       proxy: nil,
       record_har_content: nil,
       record_har_mode: nil,

data/documentation/docs/api/frame.md

@@ -190,7 +190,6 @@ properties:
 You can also specify [JSHandle](./js_handle) as the property value if you want live objects to be passed into the event:
 
 ```ruby
-# note you can only create data_transfer in chromium and firefox
 data_transfer = frame.evaluate_handle("new DataTransfer()")
 frame.dispatch_event("#source", "dragstart", eventInit: { dataTransfer: data_transfer })
 ```

data/documentation/docs/api/locator.md

@@ -358,7 +358,6 @@ properties:
 You can also specify [JSHandle](./js_handle) as the property value if you want live objects to be passed into the event:
 
 ```ruby
-# note you can only create data_transfer in chromium and firefox
 data_transfer = page.evaluate_handle("new DataTransfer()")
 locator.dispatch_event("dragstart", eventInit: { dataTransfer: data_transfer })
 ```
@@ -945,7 +944,7 @@ def editable?(timeout: nil)
 ```
 
 
-Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable).
+Returns whether the element is [editable](https://playwright.dev/python/docs/actionability#editable). If the target element is not an `<input>`, `<textarea>`, `<select>`, `[contenteditable]` and does not have a role allowing `[aria-readonly]`, this method throws an error.
 
 **NOTE**: If you need to assert that an element is editable, prefer [LocatorAssertions#to_be_editable](./locator_assertions#to_be_editable) to avoid flakiness. See [assertions guide](https://playwright.dev/python/docs/test-assertions) for more details.
 
@@ -1061,16 +1060,19 @@ def or(locator)
 
 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.
+Note that when both locators match something, the resulting locator will have multiple matches, potentially causing a [locator strictness](https://playwright.dev/python/docs/locators#strictness) violation.
 
 **Usage**
 
 Consider a scenario where you'd like to click on a "New email" button, but sometimes a security settings dialog shows up instead. In this case, you can wait for either a "New email" button, or a dialog and act accordingly.
 
+**NOTE**: If both "New email" button and security dialog appear on screen, the "or" locator will match both of them,
+possibly throwing the ["strict mode violation" error](https://playwright.dev/python/docs/locators#strictness). In this case, you can use [Locator#first](./locator#first) to only match one of them.
+
 ```ruby
 new_email = page.get_by_role("button", name: "New")
 dialog = page.get_by_text("Confirm security settings")
-new_email.or(dialog).wait_for(state: 'visible')
+new_email.or(dialog).first.wait_for(state: 'visible')
 if dialog.visible?
   page.get_by_role("button", name: "Dismiss").click
 end

data/documentation/docs/api/locator_assertions.md

@@ -134,6 +134,15 @@ expect(locator).not_to have_accessible_description(name, ignoreCase: nil, timeou
 
 The opposite of [LocatorAssertions#to_have_accessible_description](./locator_assertions#to_have_accessible_description).
 
+## not_to_have_accessible_error_message
+
+```ruby
+expect(locator).not_to have_accessible_error_message(errorMessage, ignoreCase: nil, timeout: nil)
+```
+
+
+The opposite of [LocatorAssertions#to_have_accessible_error_message](./locator_assertions#to_have_accessible_error_message).
+
 ## not_to_have_accessible_name
 
 ```ruby
@@ -233,6 +242,15 @@ expect(locator).not_to have_values(values, timeout: nil)
 
 The opposite of [LocatorAssertions#to_have_values](./locator_assertions#to_have_values).
 
+## not_to_match_aria_snapshot
+
+```ruby
+expect(locator).not_to match_aria_snapshot(expected, timeout: nil)
+```
+
+
+The opposite of [LocatorAssertions#to_match_aria_snapshot](./locator_assertions#to_match_aria_snapshot).
+
 ## to_be_attached
 
 ```ruby
@@ -257,7 +275,7 @@ expect(page.get_by_text("Hidden text")).to be_attached
 ## to_be_checked
 
 ```ruby
-expect(locator).to be_checked(checked: nil, timeout: nil)
+expect(locator).to be_checked(checked: nil, indeterminate: nil, timeout: nil)
 ```
 
 
@@ -488,6 +506,22 @@ locator = page.get_by_test_id("save-button")
 expect(locator).to have_accessible_description("Save results to disk")
 ```
 
+## to_have_accessible_error_message
+
+```ruby
+expect(locator).to have_accessible_error_message(errorMessage, ignoreCase: nil, timeout: nil)
+```
+
+
+Ensures the [Locator](./locator) points to an element with a given [aria errormessage](https://w3c.github.io/aria/#aria-errormessage).
+
+**Usage**
+
+```ruby
+locator = page.get_by_test_id("username-input")
+expect(locator).to have_accessible_error_message("Username is required.")
+```
+
 ## to_have_accessible_name
 
 ```ruby
@@ -527,22 +561,21 @@ expect(locator).to have_class(expected, timeout: nil)
 ```
 
 
-Ensures the [Locator](./locator) points to an element with given CSS classes. This needs to be a full match
-or using a relaxed regular expression.
+Ensures the [Locator](./locator) points to an element with given CSS classes. When a string is provided, it must fully match the element's `class` attribute. To match individual classes or perform partial matches, use a regular expression:
 
 **Usage**
 
 ```html
-<div class='selected row' id='component'></div>
+<div class='middle selected row' id='component'></div>
 ```
 
 ```ruby
 locator = page.locator("#component")
-expect(locator).to have_class(/selected/)
-expect(locator).to have_class("selected row")
+expect(locator).to have_class(/(^|\s)selected(\s|$)/)
+expect(locator).to have_class("middle selected row")
 ```
 
-Note that if array is passed as an expected value, entire lists of elements can be asserted:
+When an array is passed, the method asserts that the list of elements located matches the corresponding list of expected class values. Each element's class attribute is matched against the corresponding string or regular expression in the array:
 
 ```ruby
 locator = page.locator("list > .component")
@@ -741,7 +774,7 @@ Asserts that the target element matches the given [accessibility snapshot](https
 
 ```ruby
 page.goto('https://demo.playwright.dev/todomvc/')
-expect(page.locator('body')).to_match_aria_snapshot(<<~YAML)
+expect(page.locator('body')).to match_aria_snapshot(<<~YAML)
 - heading "todos"
 - textbox "What needs to be done?"
 YAML

data/documentation/docs/api/page.md

@@ -253,7 +253,6 @@ You can also specify [JSHandle](./js_handle) as the property value if you want l
 ```ruby
 page.content = '<div id="source">Drag</div>'
 
-# note you can only create data_transfer in chromium and firefox
 data_transfer = page.evaluate_handle("new DataTransfer()")
 page.dispatch_event("#source", "dragstart", eventInit: { dataTransfer: data_transfer })
 ```
@@ -1063,8 +1062,6 @@ def pdf(
 
 Returns the PDF buffer.
 
-**NOTE**: Generating a pdf is currently only supported in Chromium headless.
-
 `page.pdf()` generates a pdf of the page with `print` css media. To generate a pdf with `screen` media, call
 [Page#emulate_media](./page#emulate_media) before calling `page.pdf()`:
 

data/documentation/docs/include/api_coverage.md

@@ -565,6 +565,7 @@
 * not_to_be_visible
 * not_to_contain_text
 * not_to_have_accessible_description
+* not_to_have_accessible_error_message
 * not_to_have_accessible_name
 * not_to_have_attribute
 * not_to_have_class
@@ -576,6 +577,7 @@
 * not_to_have_text
 * not_to_have_value
 * not_to_have_values
+* not_to_match_aria_snapshot
 * to_be_attached
 * to_be_checked
 * to_be_disabled
@@ -588,6 +590,7 @@
 * to_be_visible
 * to_contain_text
 * to_have_accessible_description
+* to_have_accessible_error_message
 * to_have_accessible_name
 * to_have_attribute
 * to_have_class

data/lib/playwright/locator_assertions_impl.rb

@@ -149,7 +149,7 @@ module Playwright
     _define_negation :to_contain_text
 
     def to_have_accessible_name(name, ignoreCase: nil, timeout: nil)
-      expected_text = to_expected_text_values([name], ignore_case: ignoreCase)
+      expected_text = to_expected_text_values([name], ignore_case: ignoreCase, normalize_white_space: true)
       expect_impl(
         "to.have.accessible.name",
         {
@@ -163,7 +163,7 @@ module Playwright
     _define_negation :to_have_accessible_name
 
     def to_have_accessible_description(name, ignoreCase: nil, timeout: nil)
-      expected_text = to_expected_text_values([name], ignore_case: ignoreCase)
+      expected_text = to_expected_text_values([name], ignore_case: ignoreCase, normalize_white_space: true)
       expect_impl(
         "to.have.accessible.description",
         {
@@ -176,6 +176,20 @@ module Playwright
     end
     _define_negation :to_have_accessible_description
 
+    def to_have_accessible_error_message(errorMessage, ignoreCase: nil, timeout: nil)
+      expected_text = to_expected_text_values([errorMessage], ignore_case: ignoreCase, normalize_white_space: true)
+      expect_impl(
+        "to.have.accessible.error.message",
+        {
+          expectedText: expected_text,
+          timeout: timeout,
+        },
+        errorMessage,
+        "Locator expected to have accessible error message"
+      )
+    end
+    _define_negation :to_have_accessible_error_message
+
     def to_have_attribute(name, value, ignoreCase: nil, timeout: nil)
       expected_text = to_expected_text_values([value], ignore_case: ignoreCase)
       expect_impl(
@@ -372,6 +386,7 @@ module Playwright
         'Locator expected to match Aria snapshot',
       )
     end
+    _define_negation :to_match_aria_snapshot
 
     def to_be_attached(attached: nil, timeout: nil)
       expect_impl(
@@ -383,10 +398,23 @@ module Playwright
     end
     _define_negation :to_be_attached
 
-    def to_be_checked(checked: nil, timeout: nil)
+    def to_be_checked(checked: nil, indeterminate: nil, timeout: nil)
+      expected_value = {
+        indeterminate: indeterminate,
+        checked: checked,
+      }.compact
+      checked_string =
+        if indeterminate
+          "indeterminate"
+        elsif checked
+          "checked"
+        else
+          "unchecked"
+        end
+
       expect_impl(
-        (checked || checked.nil?) ? "to.be.checked" : "to.be.unchecked",
-        { timeout: timeout },
+        "to.be.checked",
+        { timeout: timeout, expectedValue: expected_value },
         nil,
         "Locator expected to be checked"
       )
@@ -466,7 +494,7 @@ module Playwright
     def to_be_in_viewport(ratio: nil, timeout: nil)
       expect_impl(
         "to.be.in.viewport",
-        { timeout: timeout, expectedNumber: ratio }.compact,
+        { timeout: timeout, expectedNumber: ratio },
         nil,
         "Locator expected to be in viewport"
       )

data/lib/playwright/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Playwright
-  VERSION = '1.49.1'
-  COMPATIBLE_PLAYWRIGHT_VERSION = '1.49.1'
+  VERSION = '1.50.1'
+  COMPATIBLE_PLAYWRIGHT_VERSION = '1.50.1'
 end

data/lib/playwright_api/android.rb

@@ -40,20 +40,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy

data/lib/playwright_api/android_device.rb

@@ -51,7 +51,6 @@ module Playwright
           baseURL: nil,
           bypassCSP: nil,
           colorScheme: nil,
-          command: nil,
           deviceScaleFactor: nil,
           extraHTTPHeaders: nil,
           forcedColors: nil,
@@ -65,6 +64,7 @@ module Playwright
           noViewport: nil,
           offline: nil,
           permissions: nil,
+          pkg: nil,
           proxy: nil,
           record_har_content: nil,
           record_har_mode: nil,
@@ -81,7 +81,7 @@ module Playwright
           userAgent: nil,
           viewport: nil,
           &block)
-      wrap_impl(@impl.launch_browser(acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), baseURL: unwrap_impl(baseURL), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), command: unwrap_impl(command), 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), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+      wrap_impl(@impl.launch_browser(acceptDownloads: unwrap_impl(acceptDownloads), args: unwrap_impl(args), 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), pkg: unwrap_impl(pkg), 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), strictSelectors: unwrap_impl(strictSelectors), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     #
@@ -193,14 +193,20 @@ module Playwright
       raise NotImplementedError.new('web_views is not implemented yet.')
     end
 
+    # @nodoc
+    def should_close_connection_on_close!
+      wrap_impl(@impl.should_close_connection_on_close!)
+    end
+
     # @nodoc
     def tap_on(selector, duration: nil, timeout: nil)
       wrap_impl(@impl.tap_on(unwrap_impl(selector), duration: unwrap_impl(duration), timeout: unwrap_impl(timeout)))
     end
 
+    # -- inherited from EventEmitter --
     # @nodoc
-    def should_close_connection_on_close!
-      wrap_impl(@impl.should_close_connection_on_close!)
+    def on(event, callback)
+      event_emitter_proxy.on(event, callback)
     end
 
     # -- inherited from EventEmitter --
@@ -215,12 +221,6 @@ module Playwright
       event_emitter_proxy.once(event, callback)
     end
 
-    # -- inherited from EventEmitter --
-    # @nodoc
-    def on(event, callback)
-      event_emitter_proxy.on(event, callback)
-    end
-
     private def event_emitter_proxy
       @event_emitter_proxy ||= EventEmitterProxy.new(self, @impl)
     end

data/lib/playwright_api/api_request_context.rb

@@ -288,20 +288,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy

data/lib/playwright_api/browser.rb

@@ -30,7 +30,7 @@ module Playwright
     # 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`].
+    # **NOTE**: This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close events, call [`method: BrowserContext.close`] on any `BrowserContext` instances you explicitly created earlier using [`method: Browser.newContext`] **before** calling [`method: Browser.close`].
     #
     # The `Browser` object itself is considered to be disposed and cannot be used anymore.
     def close(reason: nil)
@@ -203,20 +203,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_context.rb

@@ -464,8 +464,8 @@ module Playwright
     end
 
     # @nodoc
-    def pause
-      wrap_impl(@impl.pause)
+    def owner_page=(req)
+      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
     end
 
     # @nodoc
@@ -474,13 +474,13 @@ module Playwright
     end
 
     # @nodoc
-    def owner_page=(req)
-      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
+    def enable_debug_console!
+      wrap_impl(@impl.enable_debug_console!)
     end
 
     # @nodoc
-    def enable_debug_console!
-      wrap_impl(@impl.enable_debug_console!)
+    def pause
+      wrap_impl(@impl.pause)
     end
 
     # @nodoc
@@ -490,20 +490,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy

data/lib/playwright_api/browser_type.rb

@@ -20,13 +20,10 @@ module Playwright
   class BrowserType < PlaywrightApi
 
     #
-    # 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,
-          exposeNetwork: nil,
-          headers: nil,
-          slowMo: nil,
-          timeout: nil)
+    # This method attaches Playwright to an existing browser instance created via `BrowserType.launchServer` in Node.js.
+    #
+    # **NOTE**: The major and minor version of the Playwright instance that connects needs to match the version of Playwright that launches the browser (1.2.3 → is compatible with 1.2.x).
+    def connect
       raise NotImplementedError.new('connect is not implemented yet.')
     end
 
@@ -37,6 +34,8 @@ module Playwright
     #
     # **NOTE**: Connecting over the Chrome DevTools Protocol is only supported for Chromium-based browsers.
     #
+    # **NOTE**: This connection is significantly lower fidelity than the Playwright protocol connection via [`method: BrowserType.connect`]. If you are experiencing issues or attempting to use advanced functionality, you probably want to use [`method: BrowserType.connect`].
+    #
     # **Usage**
     #
     # ```python sync
@@ -177,20 +176,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy

data/lib/playwright_api/cdp_session.rb

@@ -33,20 +33,20 @@ module Playwright
 
     # -- 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
 
     # -- 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
 
     private def event_emitter_proxy