playwright-ruby-client 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b365f47558ade3fcf3d803a070cbd61eb4eae6279f0d93c1641a53d9b50ec232
-  data.tar.gz: 353de7a190205c6d3d4542b3058afe24c0c634fe70811c15384b55d1cb464571
+  metadata.gz: 623dc9bf11ce77bda6cd9006c727e31060564810bac0ccf5f06aabffc5976c07
+  data.tar.gz: 206995c24a6cbd4dcd6867eaa076e3b3052b7a7056cd63188a7ebb0e54c38056
 SHA512:
-  metadata.gz: ec905a5051716af754993c11b5a484e5bf69a9b50cdb6681f583869d0cf70d23eb3265507d6739b6d006fc8419360dea8570f6fae6fc3ac8fdd6d44ae3547fd8
-  data.tar.gz: cf06e3351a40457108080dea85af6c8e417ffda3bec6671f9280ad42bc5fde7e58cf039016fe11387a7cb3e1347e1391f1440d23c2e54e512ca70e39ba90db38
+  metadata.gz: a341d042e6e35b5205f56303efda6fe9a34e857c12696622c366f0ebbc113816b3418e05e87b8fe60867ae2252964a36545b8bd782cf61f9c23f42e868cb098a
+  data.tar.gz: 68fc458f0fc750c208f8daa7f900ef33977987aa6684db4edea20c42cf5f3837deb4e5b828385fd9c25d11769ff1b345cdb795aef370158bd009a515dfeeb54d

data/documentation/docs/api/browser.md

@@ -85,6 +85,7 @@ def new_context(
       record_har_path: nil,
       record_video_dir: nil,
       record_video_size: nil,
+      reducedMotion: nil,
       screen: nil,
       storageState: nil,
       timezoneId: nil,
@@ -132,6 +133,7 @@ def new_page(
       record_har_path: nil,
       record_video_dir: nil,
       record_video_size: nil,
+      reducedMotion: nil,
       screen: nil,
       storageState: nil,
       timezoneId: nil,

data/documentation/docs/api/browser_context.md

@@ -131,8 +131,7 @@ The method adds a function called `name` on the `window` object of every frame i
 called, the function executes `callback` and returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which resolves to the return value of `callback`. If
 the `callback` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), it will be awaited.
 
-The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-page: Page, frame: Frame }`.
+The first argument of the `callback` function contains information about the caller: `{ browser_context: BrowserContext, page: Page, frame: Frame }`.
 
 See [Page#expose_binding](./page#expose_binding) for page-only version.
 
@@ -193,7 +192,7 @@ If the `callback` returns a [Promise](https://developer.mozilla.org/en-US/docs/W
 
 See [Page#expose_function](./page#expose_function) for page-only version.
 
-An example of adding an `sha256` function to all pages in the context:
+An example of adding a `sha256` function to all pages in the context:
 
 ```ruby
 require 'digest'

data/documentation/docs/api/dialog.md

@@ -8,24 +8,21 @@ sidebar_position: 10
 
 An example of using [Dialog](./dialog) class:
 
-```python sync title=example_c954c35627e62be69e1f138f25d7377b13e18d08039d476946217827fa95db52.py
-from playwright.sync_api import sync_playwright
-
-def handle_dialog(dialog):
-    print(dialog.message)
-    dialog.dismiss()
-
-def run(playwright):
-    chromium = playwright.chromium
-    browser = chromium.launch()
-    page = browser.new_page()
-    page.on("dialog", handle_dialog)
-    page.evaluate("alert('1')")
-    browser.close()
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+def handle_dialog(dialog)
+  puts "[#{dialog.type}] #{dialog.message}"
+  if dialog.message =~ /foo/
+    dialog.accept_async
+  else
+    dialog.dismiss
+  end
+end
+
+page.on("dialog", method(:handle_dialog))
+page.evaluate("confirm('foo')") # will be accepted
+# => [confirm] foo
+page.evaluate("alert('bar')") # will be dismissed
+# => [alert] bar
 ```
 
 > NOTE: Dialogs are dismissed automatically, unless there is a [`event: Page.dialog`] listener. When listener is

data/documentation/docs/api/element_handle.md

@@ -9,21 +9,11 @@ sidebar_position: 10
 ElementHandle represents an in-page DOM element. ElementHandles can be created with the [Page#query_selector](./page#query_selector)
 method.
 
-```python sync title=example_5ba38bdc5d9e5ce7cfc9c8841eb0176efbb4690d18962066f9ee67f1e8b7b050.py
-from playwright.sync_api import sync_playwright
-
-def run(playwright):
-    chromium = playwright.chromium
-    browser = chromium.launch()
-    page = browser.new_page()
-    page.goto("https://example.com")
-    href_element = page.query_selector("a")
-    href_element.click()
-    # ...
-
-with sync_playwright() as playwright:
-    run(playwright)
-
+```ruby
+page.goto("https://example.com")
+href_element = page.query_selector("a")
+href_element.click
+# ...
 ```
 
 ElementHandle prevents DOM element from garbage collection unless the handle is disposed with
@@ -51,10 +41,12 @@ Elements from child frames return the bounding box relative to the main frame, u
 Assuming the page is static, it is safe to use bounding box coordinates to perform input. For example, the following
 snippet should click the center of the element.
 
-```python sync title=example_8382aa7cfb42a9a17e348e2f738279f1bd9a038f1ea35cc3cb244cc64d768f93.py
-box = element_handle.bounding_box()
-page.mouse.click(box["x"] + box["width"] / 2, box["y"] + box["height"] / 2)
-
+```ruby
+box = element_handle.bounding_box
+page.mouse.click(
+  box["x"] + box["width"] / 2,
+  box["y"] + box["height"] / 2,
+)
 ```
 
 
@@ -156,9 +148,8 @@ The snippet below dispatches the `click` event on the element. Regardless of the
 `click` is dispatched. This is equivalent to calling
 [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
-```python sync title=example_3b86add6ce355082cd43f4ac0ba9e69c15960bbd7ca601d0618355fe53aa8902.py
+```ruby
 element_handle.dispatch_event("click")
-
 ```
 
 Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
@@ -175,11 +166,10 @@ Since `eventInit` is event-specific, please refer to the events documentation fo
 
 You can also specify [JSHandle](./js_handle) as the property value if you want live objects to be passed into the event:
 
-```python sync title=example_6b70ea4cf0c7ae9c82cf0ed22ab0dbbb563e2d1419b35d04aa513cf91f0856f9.py
+```ruby
 # note you can only create data_transfer in chromium and firefox
 data_transfer = page.evaluate_handle("new DataTransfer()")
-element_handle.dispatch_event("#source", "dragstart", {"dataTransfer": data_transfer})
-
+element_handle.dispatch_event("dragstart", eventInit: { dataTransfer: data_transfer })
 ```
 
 
@@ -201,11 +191,10 @@ and return its value.
 
 Examples:
 
-```python sync title=example_f6a83ec555fcf23877c11cf55f02a8c89a7fc11d3324859feda42e592e129f4f.py
+```ruby
 tweet_handle = page.query_selector(".tweet")
-assert tweet_handle.eval_on_selector(".like", "node => node.innerText") == "100"
-assert tweet_handle.eval_on_selector(".retweets", "node => node.innerText") = "10"
-
+tweet_handle.eval_on_selector(".like", "node => node.innerText") # => "100"
+tweet_handle.eval_on_selector(".retweets", "node => node.innerText") # => "10"
 ```
 
 
@@ -233,10 +222,9 @@ Examples:
 </div>
 ```
 
-```python sync title=example_11b54bf5ec18a0d0ceee0868651bb41ab5cd3afcc6b20d5c44f90d835c8d6f81.py
+```ruby
 feed_handle = page.query_selector(".feed")
-assert feed_handle.eval_on_selector_all(".tweet", "nodes => nodes.map(n => n.innerText)") == ["hello!", "hi!"]
-
+feed_handle.eval_on_selector_all(".tweet", "nodes => nodes.map(n => n.innerText)") # => ["hello!", "hi!"]
 ```
 
 
@@ -463,26 +451,18 @@ Returns the array of option values that have been successfully selected.
 
 Triggers a `change` and `input` event once all the provided options have been selected.
 
-```python sync title=example_dc2ce38846b91d234483ed8b915b785ffbd9403213279465acd6605f314fe736.py
+```ruby
 # single selection matching the value
-handle.select_option("blue")
+element_handle.select_option(value: "blue")
 # single selection matching both the label
-handle.select_option(label="blue")
+element_handle.select_option(label: "blue")
 # multiple selection
-handle.select_option(value=["red", "green", "blue"])
-
+element_handle.select_option(value: ["red", "green", "blue"])
 ```
 
-```python sync title=example_b4cdd4a1a4d0392c2d430e0fb5fc670df2d728b6907553650690a2d0377662e4.py
-# single selection matching the value
-handle.select_option("blue")
-# single selection matching both the value and the label
-handle.select_option(label="blue")
-# multiple selection
-handle.select_option("red", "green", "blue")
+```ruby
 # multiple selection for blue, red and second option
-handle.select_option(value="blue", { index: 2 }, "red")
-
+element_handle.select_option(value: "blue", index: 2, label: "red")
 ```
 
 
@@ -552,19 +532,17 @@ Focuses the element, and then sends a `keydown`, `keypress`/`input`, and `keyup`
 
 To press a special key, like `Control` or `ArrowDown`, use [ElementHandle#press](./element_handle#press).
 
-```python sync title=example_2dc9720467640fd8bc581ed65159742e51ff91b209cb176fef8b95f14eaad54e.py
+```ruby
 element_handle.type("hello") # types instantly
-element_handle.type("world", delay=100) # types slower, like a user
-
+element_handle.type("world", delay: 100) # types slower, like a user
 ```
 
 An example of typing into a text field and then submitting the form:
 
-```python sync title=example_d13faaf53454653ce45371b5cf337082a82bf7bbb0aada7e97f47d14963bd6b0.py
+```ruby
 element_handle = page.query_selector("input")
 element_handle.type("some text")
 element_handle.press("Enter")
-
 ```
 
 

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

@@ -47,6 +47,7 @@ def launch_browser(
       record_har_path: nil,
       record_video_dir: nil,
       record_video_size: nil,
+      reducedMotion: nil,
       screen: nil,
       timezoneId: nil,
       userAgent: nil,

data/documentation/docs/api/file_chooser.md

@@ -6,12 +6,11 @@ sidebar_position: 10
 
 [FileChooser](./file_chooser) objects are dispatched by the page in the [`event: Page.fileChooser`] event.
 
-```python sync title=example_371975841dd417527a865b1501e3a8ba40f905b895cf3317ca90d9890e980843.py
-with page.expect_file_chooser() as fc_info:
-    page.click("upload")
-file_chooser = fc_info.value
+```ruby
+file_chooser = page.expect_file_chooser do
+  page.click("upload") # action to trigger file uploading
+end
 file_chooser.set_files("myfile.pdf")
-
 ```
 
 

data/documentation/docs/api/frame.md

@@ -308,9 +308,8 @@ a_window_handle # handle for the window object.
 
 A string can also be passed in instead of a function.
 
-```python sync title=example_9daa37cfd3d747c9360d9544f64786bf49d291a6887b0efccc813215b62ae4c6.py
+```ruby
 a_handle = page.evaluate_handle("document") # handle for the "document"
-
 ```
 
 [JSHandle](./js_handle) instances can be passed as an argument to the [Frame#evaluate_handle](./frame#evaluate_handle):
@@ -318,8 +317,8 @@ a_handle = page.evaluate_handle("document") # handle for the "document"
 ```ruby
 body_handle = page.evaluate_handle("document.body")
 result_handle = page.evaluate_handle("body => body.innerHTML", arg: body_handle)
-puts result_handle.json_value()
-result_handle.dispose()
+puts result_handle.json_value
+result_handle.dispose
 ```
 
 

data/documentation/docs/api/js_handle.md

@@ -7,10 +7,9 @@ sidebar_position: 10
 JSHandle represents an in-page JavaScript object. JSHandles can be created with the [Page#evaluate_handle](./page#evaluate_handle)
 method.
 
-```python sync title=example_c408a96b8ac9c9bd54d915009c8b477eb75b7bf9e879fd76b32f3d4b6340a667.py
+```ruby
 window_handle = page.evaluate_handle("window")
 # ...
-
 ```
 
 JSHandle prevents the referenced JavaScript object being garbage collected unless the handle is exposed with
@@ -50,10 +49,9 @@ If `expression` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web
 
 Examples:
 
-```python sync title=example_2400f96eaaed3bc6ef6b0a16ba48e83d38a166c7d55a5dba0025472cffc6f2be.py
+```ruby
 tweet_handle = page.query_selector(".tweet .retweets")
-assert tweet_handle.evaluate("node => node.innerText") == "10 retweets"
-
+tweet_handle.evaluate("node => node.innerText") # => "10 retweets"
 ```
 
 
@@ -68,10 +66,10 @@ Returns the return value of `expression` as a [JSHandle](./js_handle).
 
 This method passes this handle as the first argument to `expression`.
 
-The only difference between `jsHandle.evaluate` and `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle` returns
+The only difference between [JSHandle#evaluate](./js_handle#evaluate) and [JSHandle#evaluate_handle](./js_handle#evaluate_handle) is that [JSHandle#evaluate_handle](./js_handle#evaluate_handle) returns
 [JSHandle](./js_handle).
 
-If the function passed to the `jsHandle.evaluateHandle` returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), then `jsHandle.evaluateHandle` would wait
+If the function passed to the [JSHandle#evaluate_handle](./js_handle#evaluate_handle) returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), then [JSHandle#evaluate_handle](./js_handle#evaluate_handle) would wait
 for the promise to resolve and return its value.
 
 See [Page#evaluate_handle](./page#evaluate_handle) for more details.
@@ -85,13 +83,12 @@ alias: `properties`
 
 The method returns a map with **own property names** as keys and JSHandle instances for the property values.
 
-```python sync title=example_8292f0e8974d97d20be9bb303d55ccd2d50e42f954e0ada4958ddbef2c6c2977.py
-handle = page.evaluate_handle("{window, document}")
-properties = handle.get_properties()
-window_handle = properties.get("window")
-document_handle = properties.get("document")
-handle.dispose()
-
+```ruby
+page.goto('https://example.com/')
+window_handle = page.evaluate_handle("window")
+properties = window_handle.properties
+puts properties
+window_handle.dispose
 ```
 
 

data/documentation/docs/api/page.md

@@ -224,9 +224,9 @@ The snippet below dispatches the `click` event on the element. Regardless of the
 `click` is dispatched. This is equivalent to calling
 [element.click()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click).
 
-```python sync title=example_9220b94fd2fa381ab91448dcb551e2eb9806ad331c83454a710f4d8a280990e8.py
+```ruby
+page.content = '<button id="submit">Send</button>'
 page.dispatch_event("button#submit", "click")
-
 ```
 
 Under the hood, it creates an instance of an event based on the given `type`, initializes it with `eventInit` properties
@@ -243,11 +243,12 @@ Since `eventInit` is event-specific, please refer to the events documentation fo
 
 You can also specify [JSHandle](./js_handle) as the property value if you want live objects to be passed into the event:
 
-```python sync title=example_9b4482b7243b7ce304d6ce8454395e23db30f3d1d83229242ab7bd2abd5b72e0.py
+```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", { "dataTransfer": data_transfer })
-
+page.dispatch_event("#source", "dragstart", eventInit: { dataTransfer: data_transfer })
 ```
 
 
@@ -255,40 +256,30 @@ page.dispatch_event("#source", "dragstart", { "dataTransfer": data_transfer })
 ## emulate_media
 
 ```
-def emulate_media(colorScheme: nil, media: nil)
+def emulate_media(colorScheme: nil, media: nil, reducedMotion: nil)
 ```
 
 This method changes the `CSS media type` through the `media` argument, and/or the `'prefers-colors-scheme'` media
 feature, using the `colorScheme` argument.
 
-```python sync title=example_df304caf6c61f6f44b3e2b0006a7e05552362a47b17c9ba227df76e918d88a5c.py
-page.evaluate("matchMedia('screen').matches")
-# → True
-page.evaluate("matchMedia('print').matches")
-# → False
-
-page.emulate_media(media="print")
-page.evaluate("matchMedia('screen').matches")
-# → False
-page.evaluate("matchMedia('print').matches")
-# → True
+```ruby
+page.evaluate("matchMedia('screen').matches") # => true
+page.evaluate("matchMedia('print').matches") # => false
 
-page.emulate_media()
-page.evaluate("matchMedia('screen').matches")
-# → True
-page.evaluate("matchMedia('print').matches")
-# → False
+page.emulate_media(media: "print")
+page.evaluate("matchMedia('screen').matches") # => false
+page.evaluate("matchMedia('print').matches") # => true
 
+page.emulate_media
+page.evaluate("matchMedia('screen').matches") # => true
+page.evaluate("matchMedia('print').matches") # => false
 ```
 
-```python sync title=example_f0479a2ee8d8f51dab94f48b7e121cade07e5026d4f602521cc6ccc47feb5a98.py
-page.emulate_media(color_scheme="dark")
-page.evaluate("matchMedia('(prefers-color-scheme: dark)').matches")
-# → True
-page.evaluate("matchMedia('(prefers-color-scheme: light)').matches")
-# → False
-page.evaluate("matchMedia('(prefers-color-scheme: no-preference)').matches")
-
+```ruby
+page.emulate_media(colorScheme="dark")
+page.evaluate("matchMedia('(prefers-color-scheme: dark)').matches") # => true
+page.evaluate("matchMedia('(prefers-color-scheme: light)').matches") # => false
+page.evaluate("matchMedia('(prefers-color-scheme: no-preference)').matches") # => false
 ```
 
 
@@ -370,7 +361,7 @@ puts page.evaluate("1 + #{x}") # => "11"
 ```ruby
 body_handle = page.query_selector("body")
 html = page.evaluate("([body, suffix]) => body.innerHTML + suffix", arg: [body_handle, "hello"])
-body_handle.dispose()
+body_handle.dispose
 ```
 
 Shortcut for main frame's [Frame#evaluate](./frame#evaluate).
@@ -389,17 +380,15 @@ The only difference between [Page#evaluate](./page#evaluate) and [Page#evaluate_
 If the function passed to the [Page#evaluate_handle](./page#evaluate_handle) returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), then [Page#evaluate_handle](./page#evaluate_handle)
 would wait for the promise to resolve and return its value.
 
-```python sync title=example_6802829f93cc4da7e67f3886b9773c7b84054afa84251add50704f8ca6837138.py
+```ruby
 a_window_handle = page.evaluate_handle("Promise.resolve(window)")
 a_window_handle # handle for the window object.
-
 ```
 
 A string can also be passed in instead of a function:
 
-```python sync title=example_9daa37cfd3d747c9360d9544f64786bf49d291a6887b0efccc813215b62ae4c6.py
+```ruby
 a_handle = page.evaluate_handle("document") # handle for the "document"
-
 ```
 
 [JSHandle](./js_handle) instances can be passed as an argument to the [Page#evaluate_handle](./page#evaluate_handle):
@@ -407,8 +396,8 @@ a_handle = page.evaluate_handle("document") # handle for the "document"
 ```ruby
 body_handle = page.evaluate_handle("document.body")
 result_handle = page.evaluate_handle("body => body.innerHTML", arg: body_handle)
-puts result_handle.json_value()
-result_handle.dispose()
+puts result_handle.json_value
+result_handle.dispose
 ```
 
 
@@ -423,8 +412,7 @@ The method adds a function called `name` on the `window` object of every frame i
 executes `callback` and returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which resolves to the return value of `callback`. If the `callback` returns
 a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise), it will be awaited.
 
-The first argument of the `callback` function contains information about the caller: `{ browserContext: BrowserContext,
-page: Page, frame: Frame }`.
+The first argument of the `callback` function contains information about the caller: `{ browser_context: BrowserContext, page: Page, frame: Frame }`.
 
 See [BrowserContext#expose_binding](./browser_context#expose_binding) for the context-wide version.
 
@@ -432,46 +420,39 @@ 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_551f5963351bfd7141fa8c94f5f22c305ec1c01d617861953374e9290929a551.py
-from playwright.sync_api import sync_playwright
-
-def run(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.click("button")
 ```
 
 An example of passing an element handle:
 
-```python sync title=example_6534a792e99e05b5644cea6e5b77ca5d864675a3012f447f0f8318c4fa6a6a54.py
-def print(source, element):
-    print(element.text_content())
+```ruby
+def print_text(source, element)
+  element.text_content
+end
 
-page.expose_binding("clicked", print, handle=true)
-page.set_content("""
-  <script>
-    document.addEventListener('click', event => window.clicked(event.target));
-  </script>
-  <div>Click me</div>
-  <div>Or click me</div>
-""")
+page.expose_binding("clicked", method(:print_text), handle: true)
+page.content = <<~HTML
+<script>
+  document.addEventListener('click', async (event) => {
+    alert(await window.clicked(event.target));
+  })
+</script>
+<div>Click me</div>
+<div>Or click me</div>
+HTML
 
+page.click('div')
 ```
 
 
@@ -491,37 +472,26 @@ See [BrowserContext#expose_function](./browser_context#expose_function) for cont
 
 > NOTE: Functions installed via [Page#expose_function](./page#expose_function) survive navigations.
 
-An example of adding an `sha1` function to the page:
-
-```python sync title=example_496ab45e0c5f4c47869f66c2b738fbd9eef0ef4065fa923caf9c929e50e14c21.py
-import hashlib
-from playwright.sync_api import sync_playwright
+An example of adding a `sha256` function to the page:
 
-def sha1(text):
-    m = hashlib.sha1()
-    m.update(bytes(text, "utf8"))
-    return m.hexdigest()
-
-
-def run(playwright):
-    webkit = playwright.webkit
-    browser = webkit.launch(headless=False)
-    page = browser.new_page()
-    page.expose_function("sha1", sha1)
-    page.set_content("""
-        <script>
-          async function onClick() {
-            document.querySelector('div').textContent = await window.sha1('PLAYWRIGHT');
-          }
-        </script>
-        <button onclick="onClick()">Click me</button>
-        <div></div>
-    """)
-    page.click("button")
+```ruby
+require 'digest'
 
-with sync_playwright() as playwright:
-    run(playwright)
+def sha1(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.click("button")
 ```
 
 
@@ -564,14 +534,12 @@ def frame(name: nil, url: nil)
 
 Returns frame matching the specified criteria. Either `name` or `url` must be specified.
 
-```py title=example_034f224ec0f7b4d98fdf875cefbc7e6c8726a6d615cbba9b1cb8c49180fd7d69.py
-frame = page.frame(name="frame-name")
-
+```ruby
+frame = page.frame(name: "frame-name")
 ```
 
-```py title=example_a8a4717d8505a35662faafa9e6c2cfbbc0a44755c8e4d43252f882b7e4f1f04a.py
-frame = page.frame(url=r".*domain.*")
-
+```ruby
+frame = page.frame(url: /.*domain.*/)
 ```
 
 
@@ -786,11 +754,10 @@ Returns the PDF buffer.
 [`-webkit-print-color-adjust`](https://developer.mozilla.org/en-US/docs/Web/CSS/-webkit-print-color-adjust) property to
 force rendering of exact colors.
 
-```python sync title=example_e079fbec8ee0607ee45cdca94df61dea36f7fd3840986d5f4ac24918569a5f5e.py
+```ruby
 # generates a pdf with "screen" media type.
-page.emulate_media(media="screen")
-page.pdf(path="page.pdf")
-
+page.emulate_media(media: "screen")
+page.pdf(path: "page.pdf")
 ```
 
 The `width`, `height`, and `margin` options accept values labeled with units. Unlabeled values are treated as pixels.
@@ -852,17 +819,14 @@ texts.
 Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are supported as well. When specified with the
 modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
-```python sync title=example_aa4598bd7dbeb8d2f8f5c0aa3bdc84042eb396de37b49f8ff8c1ea39f080f709.py
-page = browser.new_page()
+```ruby
 page.goto("https://keycode.info")
 page.press("body", "A")
-page.screenshot(path="a.png")
+page.screenshot(path: "a.png")
 page.press("body", "ArrowLeft")
-page.screenshot(path="arrow_left.png")
+page.screenshot(path: "arrow_left.png")
 page.press("body", "Shift+O")
-page.screenshot(path="o.png")
-browser.close()
-
+page.screenshot(path: "o.png")
 ```
 
 
@@ -912,35 +876,31 @@ Once routing is enabled, every request matching the url pattern will stall unles
 
 An example of a naive handler that aborts all image requests:
 
-```python sync title=example_a3038a6fd55b06cb841251877bf6eb781b08018695514c6e0054848d4e93d345.py
-page = browser.new_page()
-page.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())
+```ruby
+page.route("**/*.{png,jpg,jpeg}", ->(route, request) { route.abort })
 page.goto("https://example.com")
-browser.close()
-
 ```
 
 or the same snippet using a regex pattern instead:
 
-```python sync title=example_7fda2a761bdd66b942415ab444c6b4bb89dd87ec0f0a4a03e6775feb694f7913.py
-page = browser.new_page()
-page.route(re.compile(r"(\.png$)|(\.jpg$)"), lambda route: route.abort())
+```ruby
+page.route(/\.(png|jpg)$/, ->(route, request) { route.abort })
 page.goto("https://example.com")
-browser.close()
-
 ```
 
 It is possible to examine the request to decide the route action. For example, mocking all requests that contain some
 post data, and leaving all other requests as is:
 
-```python sync title=example_ff4fba1273c7e65f4d68b4fcdd9dc4b792bba435005f0b9e7066ca18ded750b5.py
-def handle_route(route):
-  if ("my-string" in route.request.post_data)
-    route.fulfill(body="mocked-data")
+```ruby
+def handle_route(route, request)
+  if request.post_data["my-string"]
+    mocked_data = request.post_data.merge({ "my-string" => 'mocked-data'})
+    route.fulfill(postData: mocked_data)
   else
-    route.continue_()
-page.route("/api/**", handle_route)
-
+    route.continue
+  end
+end
+page.route("/api/**", method(:handle_route))
 ```
 
 Page routes take precedence over browser context routes (set up with [BrowserContext#route](./browser_context#route)) when request
@@ -989,14 +949,13 @@ Returns the array of option values that have been successfully selected.
 
 Triggers a `change` and `input` event once all the provided options have been selected.
 
-```python sync title=example_4b17eb65721c55859c50eb12b4ee762e65408618cf3b7d07958b68d60ea6be6c.py
+```ruby
 # single selection matching the value
-page.select_option("select#colors", "blue")
+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"])
 ```
 
 Shortcut for main frame's [Frame#select_option](./frame#select_option).
@@ -1076,11 +1035,9 @@ In the case of multiple pages in a single browser, each page can have its own vi
 `page.setViewportSize` will resize the page. A lot of websites don't expect phones to change size, so you should set the
 viewport size before navigating to the page.
 
-```python sync title=example_e3883d51c0785c34b62633fe311c4f1252dd9f29e6b4b6c7719f1eb74384e6e9.py
-page = browser.new_page()
-page.set_viewport_size({"width": 640, "height": 480})
+```ruby
+page.viewport_size = { width: 640, height: 480 }
 page.goto("https://example.com")
-
 ```
 
 
@@ -1145,10 +1102,9 @@ fine-grained keyboard events. To fill values in form fields, use [Page#fill](./p
 
 To press a special key, like `Control` or `ArrowDown`, use [Keyboard#press](./keyboard#press).
 
-```python sync title=example_4c7291f6023d2fe4f957cb7727646b50fdee40275db330a6f4517e349ea7f916.py
+```ruby
 page.type("#mytextarea", "hello") # types instantly
-page.type("#mytextarea", "world", delay=100) # types slower, like a user
-
+page.type("#mytextarea", "world", delay: 100) # types slower, like a user
 ```
 
 Shortcut for main frame's [Frame#type](./frame#type).
@@ -1221,7 +1177,7 @@ def expect_console_message(predicate: nil, timeout: nil, &block)
 
 Performs action and waits for a [ConsoleMessage](./console_message) to be logged by in the page. If predicate is provided, it passes
 [ConsoleMessage](./console_message) value into the `predicate` function and waits for `predicate(message)` to return a truthy value. Will
-throw an error if the page is closed before the console event is fired.
+throw an error if the page is closed before the [`event: Page.console`] event is fired.
 
 ## expect_download
 
@@ -1242,15 +1198,13 @@ def expect_event(event, predicate: nil, timeout: nil, &block)
 Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
 value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
 
-```python sync title=example_1b007e0db5f2b594b586367be3b56f9eb9b928740efbceada2c60cb7794592d4.py
-with page.expect_event("framenavigated") as event_info:
-    page.click("button")
-frame = event_info.value
-
+```ruby
+frame = page.expect_event("framenavigated") do
+  page.click("button")
+end
 ```
 
 
-
 ## expect_file_chooser
 
 ```
@@ -1258,7 +1212,7 @@ def expect_file_chooser(predicate: nil, timeout: nil, &block)
 ```
 
 Performs action and waits for a new [FileChooser](./file_chooser) to be created. If predicate is provided, it passes [FileChooser](./file_chooser) value
-into the `predicate` function and waits for `predicate(fileChooser)` to return a truthy value. Will throw an error if
+into the `predicate` function and waits for `predicate.call(fileChooser)` to return a truthy value. Will throw an error if
 the page is closed before the file chooser is opened.
 
 ## wait_for_function
@@ -1271,28 +1225,16 @@ 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_e50869c913bec2f0a89a22ff1c438128c3c8f2e3710acb10665445cf52e3ec73.py
-from playwright.sync_api import sync_playwright
-
-def run(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:
 
-```python sync title=example_04c93558dde8de62944515a8ed91fda6e0d01feca4d3bb2e58c6fda10a8c6ade.py
+```ruby
 selector = ".foo"
-page.wait_for_function("selector => !!document.querySelector(selector)", selector)
-
+page.wait_for_function("selector => !!document.querySelector(selector)", arg: selector)
 ```
 
 Shortcut for main frame's [Frame#wait_for_function](./frame#wait_for_function).
@@ -1308,20 +1250,19 @@ Returns when the required load state has been reached.
 This resolves when the page reaches a required load state, `load` by default. The navigation must have been committed
 when this method is called. If current document has already reached the required state, resolves immediately.
 
-```python sync title=example_cd35fb085612055231ddf97f68bc5331b4620914e0686b889f2cd4061836cff8.py
+```ruby
 page.click("button") # click triggers navigation.
-page.wait_for_load_state() # the promise resolves after "load" event.
-
+page.wait_for_load_state # the promise resolves after "load" event.
 ```
 
-```python sync title=example_51ba8a745d5093516e9a50482d8bf3ce29afe507ca5cfe89f4a0e35963f52a36.py
-with page.expect_popup() as page_info:
-    page.click("button") # click triggers a popup.
-popup = page_info.value
- # Following resolves after "domcontentloaded" event.
-popup.wait_for_load_state("domcontentloaded")
-print(popup.title()) # popup is ready to use.
+```ruby
+popup = page.expect_popup do
+  page.click("button") # click triggers a popup.
+end
 
+# Following resolves after "domcontentloaded" event.
+popup.wait_for_load_state("domcontentloaded")
+puts popup.title # popup is ready to use.
 ```
 
 Shortcut for main frame's [Frame#wait_for_load_state](./frame#wait_for_load_state).
@@ -1340,17 +1281,16 @@ This resolves when the page navigates to a new URL or reloads. It is useful for
 cause the page to navigate. e.g. The click target has an `onclick` handler that triggers navigation from a `setTimeout`.
 Consider this example:
 
-```python sync title=example_bc5a01f756c1275b9942c4b3e50a9f1748c04da8d5f8f697567b9d04806ec0dc.py
-with page.expect_navigation():
-    page.click("a.delayed-navigation") # clicking the link will indirectly cause a navigation
-# Resolves after navigation has finished
-
+```ruby
+page.expect_navigation do
+  page.click("a.delayed-navigation") # clicking the link will indirectly cause a navigation
+end # Resolves after navigation has finished
 ```
 
 > 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.
 
-Shortcut for main frame's [`method: Frame.waitForNavigation`].
+Shortcut for main frame's [Frame#expect_navigation](./frame#expect_navigation).
 
 ## expect_popup
 
@@ -1358,29 +1298,32 @@ Shortcut for main frame's [`method: Frame.waitForNavigation`].
 def expect_popup(predicate: nil, timeout: nil, &block)
 ```
 
-Performs action and waits for a popup [Page](./page). If predicate is provided, it passes [Popup] value into the `predicate`
-function and waits for `predicate(page)` to return a truthy value. Will throw an error if the page is closed before the
-popup event is fired.
+Performs action and waits for a popup [Page](./page). If predicate is provided, it passes popup [Page](./page) value into the predicate function and waits for `predicate.call(page)` to return a truthy value. Will throw an error if the page is closed before the popup event is fired.
 
 ## expect_request
 
 ```
-def expect_request(urlOrPredicate, timeout: nil)
+def expect_request(urlOrPredicate, timeout: nil, &block)
 ```
 
 Waits for the matching request and returns it.  See [waiting for event](https://playwright.dev/python/docs/events) for more details
 about events.
 
-```python sync title=example_9246912bc386c2f9310662279b12200ae131f724a1ec1ca99e511568767cb9c8.py
-with page.expect_request("http://example.com/resource") as first:
-    page.click('button')
-first_request = first.value
+```ruby
+page.content = '<form action="https://example.com/resource"><input type="submit" /></form>'
+request = page.expect_request(/example.com\/resource/) do
+  page.click("input")
+end
+puts request.headers
 
-# or with a lambda
-with page.expect_request(lambda request: request.url == "http://example.com" and request.method == "get") as second:
-    page.click('img')
-second_request = second.value
+page.wait_for_load_state # wait for request finished.
 
+# or with a predicate
+page.content = '<form action="https://example.com/resource"><input type="submit" /></form>'
+request = page.expect_request(->(req) { req.url.start_with? 'https://example.com/resource' }) do
+  page.click("input")
+end
+puts request.headers
 ```
 
 
@@ -1388,23 +1331,24 @@ second_request = second.value
 ## expect_response
 
 ```
-def expect_response(urlOrPredicate, timeout: nil)
+def expect_response(urlOrPredicate, timeout: nil, &block)
 ```
 
 Returns the matched response. See [waiting for event](https://playwright.dev/python/docs/events) for more details about events.
 
-```python sync title=example_d2a76790c0bb59bf5ae2f41d1a29b50954412136de3699ec79dc33cdfd56004b.py
-with page.expect_response("https://example.com/resource") as response_info:
-    page.click("input")
-response = response_info.value
-return response.ok
-
-# or with a lambda
-with page.expect_response(lambda response: response.url == "https://example.com" and response.status === 200) as response_info:
-    page.click("input")
-response = response_info.value
-return response.ok
+```ruby
+page.content = '<form action="https://example.com/resource"><input type="submit" /></form>'
+response = page.expect_response(/example.com\/resource/) do
+  page.click("input")
+end
+puts response.body
 
+# or with a predicate
+page.content = '<form action="https://example.com/resource"><input type="submit" /></form>'
+response = page.expect_response(->(res) { res.url.start_with? 'https://example.com/resource' }) do
+  page.click("input")
+end
+puts response.body
 ```
 
 
@@ -1424,22 +1368,12 @@ selector doesn't satisfy the condition for the `timeout` milliseconds, the funct
 
 This method works across navigations:
 
-```python sync title=example_0a62ff34b0d31a64dd1597b9dff456e4139b36207d26efdec7109e278dc315a3.py
-from playwright.sync_api import sync_playwright
-
-def run(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
 ```
 
 
@@ -1452,10 +1386,9 @@ def wait_for_url(url, timeout: nil, waitUntil: nil)
 
 Waits for the main frame to navigate to the given URL.
 
-```python sync title=example_a49b1deed2b93fe358b57bca9c4032f44b3d24436a78720421ba040aad4d661c.py
+```ruby
 page.click("a.delayed-navigation") # clicking the link will indirectly cause a navigation
 page.wait_for_url("**/target.html")
-
 ```
 
 Shortcut for main frame's [Frame#wait_for_url](./frame#wait_for_url).