playwright-ruby-client 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9944a15cd23ff09a56c09f396ff276ec366670740f4c79cb553a9dedec346ff8
-  data.tar.gz: 33807cddbf67539e40d8659fd565827a1c0127ccc65c7b6a2864b8e80184053b
+  metadata.gz: 6d96f4cf4c170f020d8b73571e23f61e994e535708759b0148aec799110f3d72
+  data.tar.gz: cc6471e1da4e8f02d8b98b960a84feb67251bafd7781dec9c0d103385474f098
 SHA512:
-  metadata.gz: ece68b2c84a789d011b00dd17f27a280e26b23349cc474ec04ca00eab18df2a813a1ebda61143603de02f3abec0fc988818122a09a35d57aa101fbb5429c2beb
-  data.tar.gz: 5070dd01c89f50580c98e196e1d97b5ffcc34ab1fc7856ac9943a6bfc4743e418cac2b3632566a88c24f99ed7fad1c0c3f1c7f66f873a76c02b993eb0baf74bc
+  metadata.gz: 953724a4d98d278b2bcd63a580f433b1defb630534023ae2c3c2df426ef4717a89c6c0e546fb76df5df7ae0b16cfd01d494be36c277d890f1774d65551932fdc
+  data.tar.gz: 92be169ac6c6adeac4ac7346df21dd929de1021e38f99f01eba73a74c4327d0436b97e6ea074560f49520eada9a6cd29f399ae144a7baa93fd64cec1c63c9cd4

data/documentation/docs/api/element_handle.md

@@ -292,6 +292,7 @@ Returns element attribute value.
 def hover(
       force: nil,
       modifiers: nil,
+      noWaitAfter: nil,
       position: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/frame.md

@@ -435,7 +435,7 @@ def get_by_label(text, exact: nil)
 ```
 
 Allows locating input elements by the text of the associated label. For example, this method will find the input by
-label text Password in the following DOM:
+label text "Password" in the following DOM:
 
 ```html
 <label for="password-input">Password:</label>
@@ -464,6 +464,7 @@ def get_by_role(
       role,
       checked: nil,
       disabled: nil,
+      exact: nil,
       expanded: nil,
       includeHidden: nil,
       level: nil,
@@ -491,13 +492,59 @@ def get_by_test_id(testId)
 Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
 [Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
 
+
+
 ## get_by_text
 
 ```
 def get_by_text(text, exact: nil)
 ```
 
-Allows locating elements that contain given text.
+Allows locating elements that contain given text. Consider the following DOM structure:
+
+```html
+<div>Hello <span>world</span></div>
+<div>Hello</div>
+```
+
+You can locate by text substring, exact string, or a regular expression:
+
+```ruby
+page.content = <<~HTML
+  <div>Hello <span>world</span></div>
+  <div>Hello</div>
+HTML
+
+# Matches <span>
+locator = page.get_by_text("world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<span>world</span>')
+
+# Matches first <div>
+locator = page.get_by_text("Hello world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+
+# Matches second <div>
+locator = page.get_by_text("Hello", exact: true)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches both <div>s
+locator = page.get_by_text(/Hello/)
+expect(locator.count).to eq(2)
+expect(locator.first.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+expect(locator.last.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches second <div>
+locator = page.get_by_text(/^hello$/i)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+```
+
+See also [Locator#filter](./locator#filter) that allows to match by another criteria, like an accessible role, and then filter
+by the text content.
+
+> NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+one, turns line breaks into spaces and ignores leading and trailing whitespace.
+> NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+example, locating by text `"Log in"` matches `<input type=button value="Log in">`.
 
 ## get_by_title
 
@@ -505,7 +552,7 @@ Allows locating elements that contain given text.
 def get_by_title(text, exact: nil)
 ```
 
-Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+Allows locating elements by their title. For example, this method will find the button by its title "Place the order":
 
 ```html
 <button title='Place the order'>Order Now</button>
@@ -544,6 +591,7 @@ def hover(
       selector,
       force: nil,
       modifiers: nil,
+      noWaitAfter: nil,
       position: nil,
       strict: nil,
       timeout: nil,

data/documentation/docs/api/frame_locator.md

@@ -74,7 +74,7 @@ def get_by_label(text, exact: nil)
 ```
 
 Allows locating input elements by the text of the associated label. For example, this method will find the input by
-label text Password in the following DOM:
+label text "Password" in the following DOM:
 
 ```html
 <label for="password-input">Password:</label>
@@ -103,6 +103,7 @@ def get_by_role(
       role,
       checked: nil,
       disabled: nil,
+      exact: nil,
       expanded: nil,
       includeHidden: nil,
       level: nil,
@@ -130,13 +131,59 @@ def get_by_test_id(testId)
 Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
 [Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
 
+
+
 ## get_by_text
 
 ```
 def get_by_text(text, exact: nil)
 ```
 
-Allows locating elements that contain given text.
+Allows locating elements that contain given text. Consider the following DOM structure:
+
+```html
+<div>Hello <span>world</span></div>
+<div>Hello</div>
+```
+
+You can locate by text substring, exact string, or a regular expression:
+
+```ruby
+page.content = <<~HTML
+  <div>Hello <span>world</span></div>
+  <div>Hello</div>
+HTML
+
+# Matches <span>
+locator = page.get_by_text("world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<span>world</span>')
+
+# Matches first <div>
+locator = page.get_by_text("Hello world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+
+# Matches second <div>
+locator = page.get_by_text("Hello", exact: true)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches both <div>s
+locator = page.get_by_text(/Hello/)
+expect(locator.count).to eq(2)
+expect(locator.first.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+expect(locator.last.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches second <div>
+locator = page.get_by_text(/^hello$/i)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+```
+
+See also [Locator#filter](./locator#filter) that allows to match by another criteria, like an accessible role, and then filter
+by the text content.
+
+> NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+one, turns line breaks into spaces and ignores leading and trailing whitespace.
+> NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+example, locating by text `"Log in"` matches `<input type=button value="Log in">`.
 
 ## get_by_title
 
@@ -144,7 +191,7 @@ Allows locating elements that contain given text.
 def get_by_title(text, exact: nil)
 ```
 
-Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+Allows locating elements by their title. For example, this method will find the button by its title "Place the order":
 
 ```html
 <button title='Place the order'>Order Now</button>

data/documentation/docs/api/js_handle.md

@@ -85,10 +85,12 @@ The method returns a map with **own property names** as keys and JSHandle instan
 
 ```ruby
 page.goto('https://example.com/')
-window_handle = page.evaluate_handle("window")
-properties = window_handle.properties
+handle = page.evaluate_handle("({window, document})")
+properties = handle.properties
 puts properties
-window_handle.dispose
+window_handle = properties["window"]
+document_handle = properties["document"]
+handle.dispose
 ```
 
 

data/documentation/docs/api/keyboard.md

@@ -5,7 +5,7 @@ sidebar_position: 10
 # Keyboard
 
 Keyboard provides an api for managing a virtual keyboard. The high level api is [Keyboard#type](./keyboard#type), which takes
-raw characters and generates proper keydown, keypress/input, and keyup events on your page.
+raw characters and generates proper `keydown`, `keypress`/`input`, and `keyup` events on your page.
 
 For finer control, you can use [Keyboard#down](./keyboard#down), [Keyboard#up](./keyboard#up), and [Keyboard#insert_text](./keyboard#insert_text)
 to manually fire events as if they were generated from a real keyboard.

data/documentation/docs/api/locator.md

@@ -25,6 +25,14 @@ def all_text_contents
 
 Returns an array of `node.textContent` values for all matching nodes.
 
+## blur
+
+```
+def blur(timeout: nil)
+```
+
+Calls [blur](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur) on the element.
+
 ## bounding_box
 
 ```
@@ -79,6 +87,20 @@ If the element is detached from the DOM at any moment during the action, this me
 When all steps combined have not finished during the specified `timeout`, this method throws a `TimeoutError`. Passing
 zero timeout disables this.
 
+## clear
+
+```
+def clear(force: nil, noWaitAfter: nil, timeout: nil)
+```
+
+This method waits for [actionability](https://playwright.dev/python/docs/actionability) checks, focuses the element, clears it and triggers an
+`input` event after clearing.
+
+If the target element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error.
+However, if the element is inside the `<label>` element that has an associated
+[control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), the control will be cleared
+instead.
+
 ## click
 
 ```
@@ -382,7 +404,7 @@ def get_by_label(text, exact: nil)
 ```
 
 Allows locating input elements by the text of the associated label. For example, this method will find the input by
-label text Password in the following DOM:
+label text "Password" in the following DOM:
 
 ```html
 <label for="password-input">Password:</label>
@@ -411,6 +433,7 @@ def get_by_role(
       role,
       checked: nil,
       disabled: nil,
+      exact: nil,
       expanded: nil,
       includeHidden: nil,
       level: nil,
@@ -438,13 +461,59 @@ def get_by_test_id(testId)
 Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
 [Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
 
+
+
 ## get_by_text
 
 ```
 def get_by_text(text, exact: nil)
 ```
 
-Allows locating elements that contain given text.
+Allows locating elements that contain given text. Consider the following DOM structure:
+
+```html
+<div>Hello <span>world</span></div>
+<div>Hello</div>
+```
+
+You can locate by text substring, exact string, or a regular expression:
+
+```ruby
+page.content = <<~HTML
+  <div>Hello <span>world</span></div>
+  <div>Hello</div>
+HTML
+
+# Matches <span>
+locator = page.get_by_text("world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<span>world</span>')
+
+# Matches first <div>
+locator = page.get_by_text("Hello world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+
+# Matches second <div>
+locator = page.get_by_text("Hello", exact: true)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches both <div>s
+locator = page.get_by_text(/Hello/)
+expect(locator.count).to eq(2)
+expect(locator.first.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+expect(locator.last.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches second <div>
+locator = page.get_by_text(/^hello$/i)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+```
+
+See also [Locator#filter](./locator#filter) that allows to match by another criteria, like an accessible role, and then filter
+by the text content.
+
+> NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+one, turns line breaks into spaces and ignores leading and trailing whitespace.
+> NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+example, locating by text `"Log in"` matches `<input type=button value="Log in">`.
 
 ## get_by_title
 
@@ -452,7 +521,7 @@ Allows locating elements that contain given text.
 def get_by_title(text, exact: nil)
 ```
 
-Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+Allows locating elements by their title. For example, this method will find the button by its title "Place the order":
 
 ```html
 <button title='Place the order'>Order Now</button>
@@ -474,6 +543,7 @@ Highlight the corresponding element(s) on the screen. Useful for debugging, don'
 def hover(
       force: nil,
       modifiers: nil,
+      noWaitAfter: nil,
       position: nil,
       timeout: nil,
       trial: nil)

data/documentation/docs/api/page.md

@@ -648,7 +648,7 @@ def get_by_label(text, exact: nil)
 ```
 
 Allows locating input elements by the text of the associated label. For example, this method will find the input by
-label text Password in the following DOM:
+label text "Password" in the following DOM:
 
 ```html
 <label for="password-input">Password:</label>
@@ -677,6 +677,7 @@ def get_by_role(
       role,
       checked: nil,
       disabled: nil,
+      exact: nil,
       expanded: nil,
       includeHidden: nil,
       level: nil,
@@ -704,13 +705,59 @@ def get_by_test_id(testId)
 Locate element by the test id. By default, the `data-testid` attribute is used as a test id. Use
 [Selectors#set_test_id_attribute](./selectors#set_test_id_attribute) to configure a different test id attribute if necessary.
 
+
+
 ## get_by_text
 
 ```
 def get_by_text(text, exact: nil)
 ```
 
-Allows locating elements that contain given text.
+Allows locating elements that contain given text. Consider the following DOM structure:
+
+```html
+<div>Hello <span>world</span></div>
+<div>Hello</div>
+```
+
+You can locate by text substring, exact string, or a regular expression:
+
+```ruby
+page.content = <<~HTML
+  <div>Hello <span>world</span></div>
+  <div>Hello</div>
+HTML
+
+# Matches <span>
+locator = page.get_by_text("world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<span>world</span>')
+
+# Matches first <div>
+locator = page.get_by_text("Hello world")
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+
+# Matches second <div>
+locator = page.get_by_text("Hello", exact: true)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches both <div>s
+locator = page.get_by_text(/Hello/)
+expect(locator.count).to eq(2)
+expect(locator.first.evaluate('e => e.outerHTML')).to eq('<div>Hello <span>world</span></div>')
+expect(locator.last.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+
+# Matches second <div>
+locator = page.get_by_text(/^hello$/i)
+expect(locator.evaluate('e => e.outerHTML')).to eq('<div>Hello</div>')
+```
+
+See also [Locator#filter](./locator#filter) that allows to match by another criteria, like an accessible role, and then filter
+by the text content.
+
+> NOTE: Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into
+one, turns line breaks into spaces and ignores leading and trailing whitespace.
+> NOTE: Input elements of the type `button` and `submit` are matched by their `value` instead of the text content. For
+example, locating by text `"Log in"` matches `<input type=button value="Log in">`.
 
 ## get_by_title
 
@@ -718,7 +765,7 @@ Allows locating elements that contain given text.
 def get_by_title(text, exact: nil)
 ```
 
-Allows locating elements by their title. For example, this method will find the button by its title "Submit":
+Allows locating elements by their title. For example, this method will find the button by its title "Place the order":
 
 ```html
 <button title='Place the order'>Order Now</button>
@@ -781,6 +828,7 @@ def hover(
       selector,
       force: nil,
       modifiers: nil,
+      noWaitAfter: nil,
       position: nil,
       strict: nil,
       timeout: nil,

data/documentation/docs/api/request.md

@@ -15,7 +15,7 @@ the  [`event: Page.requestFailed`] event is emitted.
 > NOTE: HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will
 complete with `'requestfinished'` event.
 
-If request gets a 'redirect' response, the request is successfully finished with the 'requestfinished' event, and a new
+If request gets a 'redirect' response, the request is successfully finished with the `requestfinished` event, and a new
 request is  issued to a redirected url.
 
 ## all_headers

data/documentation/docs/article/guides/rails_integration.md

@@ -95,6 +95,7 @@ These parameters can be passed into `Capybara::Playwright::Driver.new`
   * record_video_dir
   * record_video_size
   * screen
+  * serviceWorkers
   * storageState
   * timezoneId
   * userAgent

data/documentation/docs/include/api_coverage.md

@@ -420,8 +420,10 @@
 
 * all_inner_texts
 * all_text_contents
+* blur
 * bounding_box
 * check
+* clear
 * click
 * count
 * dblclick
@@ -519,6 +521,7 @@
 
 ## Android
 
+* ~~connect~~
 * devices
 * ~~set_default_timeout~~
 

data/lib/playwright/channel_owner.rb

@@ -36,6 +36,7 @@ module Playwright
       @type = type
       @guid = guid
       @initializer = initializer
+      @event_to_subscription_mapping = {}
 
       after_initialize
     end
@@ -59,6 +60,46 @@ module Playwright
       @objects.clear
     end
 
+    private def set_event_to_subscription_mapping(event_to_subscription_mapping)
+      @event_to_subscription_mapping = event_to_subscription_mapping
+    end
+
+    private def update_subscription(event, enabled)
+      protocol_event = @event_to_subscription_mapping[event]
+      if protocol_event
+        payload = {
+          event: protocol_event,
+          enabled: enabled,
+        }
+        @channel.async_send_message_to_server('updateSubscription', payload)
+      end
+    end
+
+    # @override
+    def on(event, callback)
+      if listener_count(event) == 0
+        update_subscription(event, true)
+      end
+      super
+    end
+
+    # @override
+    def once(event, callback)
+      if listener_count(event) == 0
+        update_subscription(event, true)
+      end
+      super
+    end
+
+    # @override
+    def off(event, callback)
+      super
+      if listener_count(event) == 0
+        update_subscription(event, false)
+      end
+    end
+
+
     # Suppress long long inspect log and avoid RSpec from hanging up...
     def inspect
       to_s

data/lib/playwright/channel_owners/browser_context.rb

@@ -58,6 +58,12 @@ module Playwright
           ChannelOwners::Page.from_nullable(params['page']),
         )
       })
+      set_event_to_subscription_mapping({
+        Events::BrowserContext::Request => "request",
+        Events::BrowserContext::Response => "response",
+        Events::BrowserContext::RequestFinished => "requestFinished",
+        Events::BrowserContext::RequestFailed => "requestFailed",
+      })
 
       @closed_promise = Concurrent::Promises.resolvable_future
     end

data/lib/playwright/channel_owners/element_handle.rb

@@ -76,10 +76,17 @@ module Playwright
         nil
       end
 
-      def hover(force: nil, modifiers: nil, position: nil, timeout: nil, trial: nil)
+      def hover(
+            force: nil,
+            modifiers: nil,
+            noWaitAfter: nil,
+            position: nil,
+            timeout: nil,
+            trial: nil)
         params = {
           force: force,
           modifiers: modifiers,
+          noWaitAfter: noWaitAfter,
           position: position,
           timeout: timeout,
           trial: trial,

data/lib/playwright/channel_owners/frame.rb

@@ -461,6 +461,7 @@ module Playwright
           selector,
           force: nil,
           modifiers: nil,
+          noWaitAfter: nil,
           position: nil,
           strict: nil,
           timeout: nil,
@@ -469,6 +470,7 @@ module Playwright
         selector: selector,
         force: force,
         modifiers: modifiers,
+        noWaitAfter: noWaitAfter,
         position: position,
         strict: strict,
         timeout: timeout,