playwright-ruby-client 1.39.0 → 1.39.1

data/documentation/docs/api/page.md

@@ -12,21 +12,12 @@ instance might have multiple [Page](./page) instances.
 
 This example creates a page, navigates it to a URL, and then saves a screenshot:
 
-```python sync title=example_94e620cdbdfd41e2c9b14d561052ffa89535fc346038c4584ea4dd8520f5401c.py
-from playwright.sync_api import sync_playwright, Playwright
-
-def run(playwright: Playwright):
-    webkit = playwright.webkit
-    browser = webkit.launch()
-    context = browser.new_context()
-    page = context.new_page()
-    page.goto("https://example.com")
-    page.screenshot(path="screenshot.png")
-    browser.close()
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+playwright.webkit.launch do |browser|
+  page = browser.new_page
+  page.goto('https://example.com/')
+  page.screenshot(path: 'screenshot.png')
+end
 ```
 
 The Page class emits various events (described below) which can be handled using any of Node's native
@@ -471,29 +462,18 @@ See [BrowserContext#expose_binding](./browser_context#expose_binding) for the co
 
 An example of exposing page URL to all frames in a page:
 
-```python sync title=example_4f7d99a72aaea957cc5678ed8728965338d78598d7772f47fbf23c28f0eba52d.py
-from playwright.sync_api import sync_playwright, Playwright
-
-def run(playwright: Playwright):
-    webkit = playwright.webkit
-    browser = webkit.launch(headless=false)
-    context = browser.new_context()
-    page = context.new_page()
-    page.expose_binding("pageURL", lambda source: source["page"].url)
-    page.set_content("""
-    <script>
-      async function onClick() {
-        document.querySelector('div').textContent = await window.pageURL();
-      }
-    </script>
-    <button onclick="onClick()">Click me</button>
-    <div></div>
-    """)
-    page.click("button")
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+page.expose_binding("pageURL", ->(source) { source[:page].url })
+page.content = <<~HTML
+<script>
+  async function onClick() {
+    document.querySelector('div').textContent = await window.pageURL();
+  }
+</script>
+<button onclick="onClick()">Click me</button>
+<div></div>
+HTML
+page.locator("button").click
 ```
 
 An example of passing an element handle:
@@ -537,35 +517,24 @@ See [BrowserContext#expose_function](./browser_context#expose_function) for cont
 
 An example of adding a `sha256` function to the page:
 
-```python sync title=example_0f68a39bdff02a3df161c74e81cabb8a2ff1f09f0d09f6ef9b799a6f2f19a280.py
-import hashlib
-from playwright.sync_api import sync_playwright, Playwright
-
-def sha256(text):
-    m = hashlib.sha256()
-    m.update(bytes(text, "utf8"))
-    return m.hexdigest()
-
-
-def run(playwright: Playwright):
-    webkit = playwright.webkit
-    browser = webkit.launch(headless=False)
-    page = browser.new_page()
-    page.expose_function("sha256", sha256)
-    page.set_content("""
-        <script>
-          async function onClick() {
-            document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
-          }
-        </script>
-        <button onclick="onClick()">Click me</button>
-        <div></div>
-    """)
-    page.click("button")
+```ruby
+require 'digest'
 
-with sync_playwright() as playwright:
-    run(playwright)
+def sha256(text)
+  Digest::SHA256.hexdigest(text)
+end
 
+page.expose_function("sha256", method(:sha256))
+page.content = <<~HTML
+<script>
+  async function onClick() {
+    document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
+  }
+</script>
+<button onclick="onClick()">Click me</button>
+<div></div>
+HTML
+page.locator("button").click
 ```
 
 ## fill
@@ -1355,14 +1324,13 @@ Triggers a `change` and `input` event once all the provided options have been se
 
 **Usage**
 
-```python sync title=example_8260034c740933903e5a39d30a4f4e388bdffa9e82acd9a5fe1fb774752a505a.py
-# Single selection matching the value or label
-page.select_option("select#colors", "blue")
+```ruby
+# single selection matching the value
+page.select_option("select#colors", value: "blue")
 # single selection matching both the label
-page.select_option("select#colors", label="blue")
+page.select_option("select#colors", label: "blue")
 # multiple selection
-page.select_option("select#colors", value=["red", "green", "blue"])
-
+page.select_option("select#colors", value: ["red", "green", "blue"])
 ```
 
 ## set_checked
@@ -1676,20 +1644,9 @@ Returns when the `expression` returns a truthy value. It resolves to a JSHandle
 
 The [Page#wait_for_function](./page#wait_for_function) can be used to observe viewport size change:
 
-```python sync title=example_83eed1f1f00ad73f641bf4a49f672e81c4faf1ca098a4a5070afeeabb88312f5.py
-from playwright.sync_api import sync_playwright, Playwright
-
-def run(playwright: Playwright):
-    webkit = playwright.webkit
-    browser = webkit.launch()
-    page = browser.new_page()
-    page.evaluate("window.x = 0; setTimeout(() => { window.x = 100 }, 1000);")
-    page.wait_for_function("() => window.x > 0")
-    browser.close()
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+page.evaluate("window.x = 0; setTimeout(() => { window.x = 100 }, 1000);")
+page.wait_for_function("() => window.x > 0")
 ```
 
 To pass an argument to the predicate of [Page#wait_for_function](./page#wait_for_function) function:
@@ -1857,22 +1814,12 @@ function will throw.
 
 This method works across navigations:
 
-```python sync title=example_903c7325fd65fcdf6f22c77fc159922a568841abce60ae1b7c54ab5837401862.py
-from playwright.sync_api import sync_playwright, Playwright
-
-def run(playwright: Playwright):
-    chromium = playwright.chromium
-    browser = chromium.launch()
-    page = browser.new_page()
-    for current_url in ["https://google.com", "https://bbc.com"]:
-        page.goto(current_url, wait_until="domcontentloaded")
-        element = page.wait_for_selector("img")
-        print("Loaded image: " + str(element.get_attribute("src")))
-    browser.close()
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+%w[https://google.com https://bbc.com].each do |current_url|
+  page.goto(current_url, waitUntil: "domcontentloaded")
+  element = page.wait_for_selector("img")
+  puts "Loaded image: #{element["src"]}"
+end
 ```
 
 ## wait_for_timeout

data/documentation/docs/api/playwright.md

@@ -8,20 +8,19 @@ sidebar_position: 10
 Playwright module provides a method to launch a browser instance. The following is a typical example of using Playwright
 to drive automation:
 
-```python sync title=example_6647e5a44b0440884026a6142606dfddad75ba1e643919b015457df4ed2e198f.py
-from playwright.sync_api import sync_playwright, Playwright
+```ruby
+require 'playwright'
 
-def run(playwright: Playwright):
-    chromium = playwright.chromium # or "firefox" or "webkit".
-    browser = chromium.launch()
-    page = browser.new_page()
-    page.goto("http://example.com")
-    # other actions...
-    browser.close()
+Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+  chromium = playwright.chromium # or "firefox" or "webkit".
+  chromium.launch do |browser|
+    page = browser.new_page
+    page.goto('https://example.com/')
 
-with sync_playwright() as playwright:
-    run(playwright)
+    # other actions
 
+  end
+end
 ```
 
 ## chromium
@@ -34,22 +33,20 @@ This object can be used to launch or connect to Chromium, returning instances of
 
 Returns a dictionary of devices to be used with [Browser#new_context](./browser#new_context) or [Browser#new_page](./browser#new_page).
 
-```python sync title=example_14d627977a4ad16a605ec5472d768a3324812fa8e7c57685561408fa6601e352.py
-from playwright.sync_api import sync_playwright, Playwright
+```ruby
+require 'playwright'
 
-def run(playwright: Playwright):
-    webkit = playwright.webkit
-    iphone = playwright.devices["iPhone 6"]
-    browser = webkit.launch()
+Playwright.create(playwright_cli_executable_path: 'npx playwright') do |playwright|
+  iphone = playwright.devices["iPhone 6"]
+  playwright.webkit.launch do |browser|
     context = browser.new_context(**iphone)
-    page = context.new_page()
-    page.goto("http://example.com")
-    # other actions...
-    browser.close()
+    page = context.new_page
+    page.goto('https://example.com/')
 
-with sync_playwright() as playwright:
-    run(playwright)
+    # other actions
 
+  end
+end
 ```
 
 ## firefox

data/documentation/docs/api/selectors.md

@@ -21,38 +21,33 @@ Selectors must be registered before creating the page.
 
 An example of registering selector engine that queries elements based on a tag name:
 
-```python sync title=example_3e739d4f0e30e20a6a698e0e17605a841c35e65e75aa3c2642f8bfc368b33f9e.py
-from playwright.sync_api import sync_playwright, Playwright
-
-def run(playwright: Playwright):
-    tag_selector = """
-      {
-          // Returns the first element matching given selector in the root's subtree.
-          query(root, selector) {
-              return root.querySelector(selector);
-          },
-          // Returns all elements matching given selector in the root's subtree.
-          queryAll(root, selector) {
-              return Array.from(root.querySelectorAll(selector));
-          }
-      }"""
-
-    # Register the engine. Selectors will be prefixed with "tag=".
-    playwright.selectors.register("tag", tag_selector)
-    browser = playwright.chromium.launch()
-    page = browser.new_page()
-    page.set_content('<div><button>Click me</button></div>')
-
-    # Use the selector prefixed with its name.
-    button = page.locator('tag=button')
-    # Combine it with built-in locators.
-    page.locator('tag=div').get_by_text('Click me').click()
-    # Can use it in any methods supporting selectors.
-    button_count = page.locator('tag=button').count()
-    print(button_count)
-    browser.close()
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+tag_selector = <<~JAVASCRIPT
+{
+    // Returns the first element matching given selector in the root's subtree.
+    query(root, selector) {
+        return root.querySelector(selector);
+    },
+    // Returns all elements matching given selector in the root's subtree.
+    queryAll(root, selector) {
+        return Array.from(root.querySelectorAll(selector));
+    }
+}
+JAVASCRIPT
+
+# Register the engine. Selectors will be prefixed with "tag=".
+playwright.selectors.register("tag", script: tag_selector)
+playwright.chromium.launch do |browser|
+  page = browser.new_page
+  page.content = '<div><button>Click me</button></div>'
+
+  # Use the selector prefixed with its name.
+  button = page.locator('tag=button')
+  # Combine it with other selector engines.
+  page.locator('tag=div').get_by_text('Click me').click
+
+  # Can use it in any methods supporting selectors.
+  button_count = page.locator('tag=button').count
+  button_count # => 1
+end
 ```

data/documentation/docs/include/api_coverage.md

@@ -527,6 +527,49 @@
 
 * ~~new_context~~
 
+## LocatorAssertions
+
+* not_to_be_attached
+* not_to_be_checked
+* not_to_be_disabled
+* not_to_be_editable
+* not_to_be_empty
+* not_to_be_enabled
+* not_to_be_focused
+* not_to_be_hidden
+* not_to_be_in_viewport
+* not_to_be_visible
+* not_to_contain_text
+* not_to_have_attribute
+* not_to_have_class
+* not_to_have_count
+* not_to_have_css
+* not_to_have_id
+* not_to_have_js_property
+* not_to_have_text
+* not_to_have_value
+* not_to_have_values
+* to_be_attached
+* to_be_checked
+* to_be_disabled
+* to_be_editable
+* to_be_empty
+* to_be_enabled
+* to_be_focused
+* to_be_hidden
+* to_be_in_viewport
+* to_be_visible
+* to_contain_text
+* to_have_attribute
+* to_have_class
+* to_have_count
+* to_have_css
+* to_have_id
+* to_have_js_property
+* to_have_text
+* to_have_value
+* to_have_values
+
 ## Android
 
 * ~~connect~~

data/lib/playwright/channel.rb

@@ -48,7 +48,7 @@ module Playwright
 
     private def with_logging(&block)
       locations = caller_locations
-      first_api_call_location_idx = locations.index { |loc| loc.absolute_path.include?('playwright_api') }
+      first_api_call_location_idx = locations.index { |loc| loc.absolute_path&.include?('playwright_api') }
       unless first_api_call_location_idx
         return block.call(nil)
       end

data/lib/playwright/errors.rb

@@ -49,4 +49,6 @@ module Playwright
 
     attr_reader :error, :page
   end
+
+  class AssertionError < StandardError; end
 end

data/lib/playwright/javascript/value_serializer.rb

@@ -24,7 +24,7 @@ module Playwright
           @handles << value.channel
           { h: index }
         when nil
-          { v: 'undefined' }
+          { v: 'null' }
         when Float::NAN
           { v: 'NaN'}
         when Float::INFINITY