playwright-ruby-client 0.0.4 → 0.0.9

data/lib/playwright_api/file_chooser.rb

@@ -3,9 +3,25 @@ module Playwright
   # 
   #
   # ```js
-  # page.on('filechooser', async (fileChooser) => {
-  #   await fileChooser.setFiles('/tmp/myfile.pdf');
-  # });
+  # const [fileChooser] = await Promise.all([
+  #   page.waitForEvent('filechooser'),
+  #   page.click('upload')
+  # ]);
+  # await fileChooser.setFiles('myfile.pdf');
+  # ```
+  # 
+  # ```python async
+  # async with page.expect_file_chooser() as fc_info:
+  #     await page.click("upload")
+  # file_chooser = await fc_info.value
+  # await file_chooser.set_files("myfile.pdf")
+  # ```
+  # 
+  # ```python sync
+  # with page.expect_file_chooser() as fc_info:
+  #     page.click("upload")
+  # file_chooser = fc_info.value
+  # file_chooser.set_files("myfile.pdf")
   # ```
   class FileChooser < PlaywrightApi
 
@@ -29,5 +45,6 @@ module Playwright
     def set_files(files, noWaitAfter: nil, timeout: nil)
       raise NotImplementedError.new('set_files is not implemented yet.')
     end
+    alias_method :files=, :set_files
   end
 end

data/lib/playwright_api/frame.rb

@@ -31,77 +31,55 @@ module Playwright
   # })();
   # ```
   # 
-  # An example of getting text from an iframe element:
+  # ```python async
+  # import asyncio
+  # from playwright.async_api import async_playwright
   # 
-  #
-  # ```js
-  # const frame = page.frames().find(frame => frame.name() === 'myframe');
-  # const text = await frame.$eval('.selector', element => element.textContent);
-  # console.log(text);
+  # async def run(playwright):
+  #     firefox = playwright.firefox
+  #     browser = await firefox.launch()
+  #     page = await browser.new_page()
+  #     await page.goto("https://www.theverge.com")
+  #     dump_frame_tree(page.main_frame, "")
+  #     await browser.close()
+  # 
+  # def dump_frame_tree(frame, indent):
+  #     print(indent + frame.name + '@' + frame.url)
+  #     for child in frame.child_frames:
+  #         dump_frame_tree(child, indent + "    ")
+  # 
+  # async def main():
+  #     async with async_playwright() as playwright:
+  #         await run(playwright)
+  # asyncio.run(main())
+  # ```
+  # 
+  # ```python sync
+  # from playwright.sync_api import sync_playwright
+  # 
+  # def run(playwright):
+  #     firefox = playwright.firefox
+  #     browser = firefox.launch()
+  #     page = browser.new_page()
+  #     page.goto("https://www.theverge.com")
+  #     dump_frame_tree(page.main_frame, "")
+  #     browser.close()
+  # 
+  # def dump_frame_tree(frame, indent):
+  #     print(indent + frame.name + '@' + frame.url)
+  #     for child in frame.child_frames:
+  #         dump_frame_tree(child, indent + "    ")
+  # 
+  # with sync_playwright() as playwright:
+  #     run(playwright)
   # ```
   class Frame < PlaywrightApi
 
-    # Returns the ElementHandle pointing to the frame element.
-    # 
-    # The method finds an element matching the specified selector within the frame. See
-    # [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector,
-    # returns `null`.
-    def query_selector(selector)
-      raise NotImplementedError.new('query_selector is not implemented yet.')
-    end
-
-    # Returns the ElementHandles pointing to the frame elements.
-    # 
-    # The method finds all elements matching the specified selector within the frame. See
-    # [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector,
-    # returns empty array.
-    def query_selector_all(selector)
-      raise NotImplementedError.new('query_selector_all is not implemented yet.')
-    end
-
-    # Returns the return value of `pageFunction`
-    # 
-    # The method finds an element matching the specified selector within the frame and passes it as a first argument to
-    # `pageFunction`. See [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements
-    # match the selector, the method throws an error.
-    # 
-    # If `pageFunction` returns a [Promise], then `frame.$eval` would wait for the promise to resolve and return its value.
-    # 
-    # Examples:
-    # 
-    #
-    # ```js
-    # const searchValue = await frame.$eval('#search', el => el.value);
-    # const preloadHref = await frame.$eval('link[rel=preload]', el => el.href);
-    # const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
-    # ```
-    def eval_on_selector(selector, pageFunction, arg: nil)
-      raise NotImplementedError.new('eval_on_selector is not implemented yet.')
-    end
-
-    # Returns the return value of `pageFunction`
-    # 
-    # The method finds all elements matching the specified selector within the frame and passes an array of matched elements
-    # as a first argument to `pageFunction`. See [Working with selectors](./selectors.md#working-with-selectors) for more
-    # details.
-    # 
-    # If `pageFunction` returns a [Promise], then `frame.$$eval` would wait for the promise to resolve and return its value.
-    # 
-    # Examples:
-    # 
-    #
-    # ```js
-    # const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
-    # ```
-    def eval_on_selector_all(selector, pageFunction, arg: nil)
-      raise NotImplementedError.new('eval_on_selector_all is not implemented yet.')
-    end
-
     # Returns the added tag when the script's onload fires or when the script content was injected into frame.
     # 
     # Adds a `<script>` tag into the page with the desired url or content.
     def add_script_tag(content: nil, path: nil, type: nil, url: nil)
-      raise NotImplementedError.new('add_script_tag is not implemented yet.')
+      wrap_impl(@impl.add_script_tag(content: unwrap_impl(content), path: unwrap_impl(path), type: unwrap_impl(type), url: unwrap_impl(url)))
     end
 
     # Returns the added tag when the stylesheet's onload fires or when the CSS content was injected into frame.
@@ -109,7 +87,7 @@ module Playwright
     # Adds a `<link rel="stylesheet">` tag into the page with the desired url or a `<style type="text/css">` tag with the
     # content.
     def add_style_tag(content: nil, path: nil, url: nil)
-      raise NotImplementedError.new('add_style_tag is not implemented yet.')
+      wrap_impl(@impl.add_style_tag(content: unwrap_impl(content), path: unwrap_impl(path), url: unwrap_impl(url)))
     end
 
     # This method checks an element matching `selector` by performing the following steps:
@@ -126,11 +104,11 @@ module Playwright
     # When all steps combined have not finished during the specified `timeout`, this method rejects with a `TimeoutError`.
     # Passing zero timeout disables this.
     def check(selector, force: nil, noWaitAfter: nil, timeout: nil)
-      raise NotImplementedError.new('check is not implemented yet.')
+      wrap_impl(@impl.check(unwrap_impl(selector), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     def child_frames
-      raise NotImplementedError.new('child_frames is not implemented yet.')
+      wrap_impl(@impl.child_frames)
     end
 
     # This method clicks an element matching `selector` by performing the following steps:
@@ -153,12 +131,12 @@ module Playwright
           noWaitAfter: nil,
           position: nil,
           timeout: nil)
-      raise NotImplementedError.new('click is not implemented yet.')
+      wrap_impl(@impl.click(unwrap_impl(selector), button: unwrap_impl(button), clickCount: unwrap_impl(clickCount), delay: unwrap_impl(delay), force: unwrap_impl(force), modifiers: unwrap_impl(modifiers), noWaitAfter: unwrap_impl(noWaitAfter), position: unwrap_impl(position), timeout: unwrap_impl(timeout)))
     end
 
     # Gets the full HTML contents of the frame, including the doctype.
     def content
-      raise NotImplementedError.new('content is not implemented yet.')
+      wrap_impl(@impl.content)
     end
 
     # This method double clicks an element matching `selector` by performing the following steps:
@@ -173,7 +151,7 @@ module Playwright
     # When all steps combined have not finished during the specified `timeout`, this method rejects with a `TimeoutError`.
     # Passing zero timeout disables this.
     # 
-    # > **NOTE** `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
+    # > NOTE: `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
     def dblclick(
           selector,
           button: nil,
@@ -183,7 +161,7 @@ module Playwright
           noWaitAfter: nil,
           position: nil,
           timeout: nil)
-      raise NotImplementedError.new('dblclick is not implemented yet.')
+      wrap_impl(@impl.dblclick(unwrap_impl(selector), button: unwrap_impl(button), delay: unwrap_impl(delay), force: unwrap_impl(force), modifiers: unwrap_impl(modifiers), noWaitAfter: unwrap_impl(noWaitAfter), position: unwrap_impl(position), timeout: unwrap_impl(timeout)))
     end
 
     # The snippet below dispatches the `click` event on the element. Regardless of the visibility state of the elment, `click`
@@ -195,6 +173,14 @@ module Playwright
     # await frame.dispatchEvent('button#submit', 'click');
     # ```
     # 
+    # ```python async
+    # await frame.dispatch_event("button#submit", "click")
+    # ```
+    # 
+    # ```python sync
+    # frame.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
     # and dispatches it on the element. Events are `composed`, `cancelable` and bubble by default.
     # 
@@ -215,18 +201,89 @@ module Playwright
     # const dataTransfer = await frame.evaluateHandle(() => new DataTransfer());
     # await frame.dispatchEvent('#source', 'dragstart', { dataTransfer });
     # ```
+    # 
+    # ```python async
+    # # note you can only create data_transfer in chromium and firefox
+    # data_transfer = await frame.evaluate_handle("new DataTransfer()")
+    # await frame.dispatch_event("#source", "dragstart", { "dataTransfer": data_transfer })
+    # ```
+    # 
+    # ```python sync
+    # # note you can only create data_transfer in chromium and firefox
+    # data_transfer = frame.evaluate_handle("new DataTransfer()")
+    # frame.dispatch_event("#source", "dragstart", { "dataTransfer": data_transfer })
+    # ```
     def dispatch_event(selector, type, eventInit: nil, timeout: nil)
-      raise NotImplementedError.new('dispatch_event is not implemented yet.')
+      wrap_impl(@impl.dispatch_event(unwrap_impl(selector), unwrap_impl(type), eventInit: unwrap_impl(eventInit), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns the return value of `pageFunction`
+    # Returns the return value of `expression`.
     # 
-    # If the function passed to the `frame.evaluate` returns a [Promise], then `frame.evaluate` would wait for the promise to
-    # resolve and return its value.
+    # The method finds an element matching the specified selector within the frame and passes it as a first argument to
+    # `expression`. See [Working with selectors](./selectors.md) for more details. If no elements match the selector, the
+    # method throws an error.
+    # 
+    # If `expression` returns a [Promise], then [`method: Frame.evalOnSelector`] would wait for the promise to resolve and
+    # return its value.
     # 
-    # If the function passed to the `frame.evaluate` returns a non-[Serializable] value, then `frame.evaluate` returns
-    # `undefined`. DevTools Protocol also supports transferring some additional values that are not serializable by `JSON`:
-    # `-0`, `NaN`, `Infinity`, `-Infinity`, and bigint literals.
+    # Examples:
+    # 
+    #
+    # ```js
+    # const searchValue = await frame.$eval('#search', el => el.value);
+    # const preloadHref = await frame.$eval('link[rel=preload]', el => el.href);
+    # const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
+    # ```
+    # 
+    # ```python async
+    # search_value = await frame.eval_on_selector("#search", "el => el.value")
+    # preload_href = await frame.eval_on_selector("link[rel=preload]", "el => el.href")
+    # html = await frame.eval_on_selector(".main-container", "(e, suffix) => e.outerHTML + suffix", "hello")
+    # ```
+    # 
+    # ```python sync
+    # search_value = frame.eval_on_selector("#search", "el => el.value")
+    # preload_href = frame.eval_on_selector("link[rel=preload]", "el => el.href")
+    # html = frame.eval_on_selector(".main-container", "(e, suffix) => e.outerHTML + suffix", "hello")
+    # ```
+    def eval_on_selector(selector, expression, arg: nil)
+      wrap_impl(@impl.eval_on_selector(unwrap_impl(selector), unwrap_impl(expression), arg: unwrap_impl(arg)))
+    end
+
+    # Returns the return value of `expression`.
+    # 
+    # The method finds all elements matching the specified selector within the frame and passes an array of matched elements
+    # as a first argument to `expression`. See [Working with selectors](./selectors.md) for more details.
+    # 
+    # If `expression` returns a [Promise], then [`method: Frame.evalOnSelectorAll`] would wait for the promise to resolve and
+    # return its value.
+    # 
+    # Examples:
+    # 
+    #
+    # ```js
+    # const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
+    # ```
+    # 
+    # ```python async
+    # divs_counts = await frame.eval_on_selector_all("div", "(divs, min) => divs.length >= min", 10)
+    # ```
+    # 
+    # ```python sync
+    # divs_counts = frame.eval_on_selector_all("div", "(divs, min) => divs.length >= min", 10)
+    # ```
+    def eval_on_selector_all(selector, expression, arg: nil)
+      wrap_impl(@impl.eval_on_selector_all(unwrap_impl(selector), unwrap_impl(expression), arg: unwrap_impl(arg)))
+    end
+
+    # Returns the return value of `expression`.
+    # 
+    # If the function passed to the [`method: Frame.evaluate`] returns a [Promise], then [`method: Frame.evaluate`] would wait
+    # for the promise to resolve and return its value.
+    # 
+    # If the function passed to the [`method: Frame.evaluate`] returns a non-[Serializable] value, then
+    # [`method: Frame.evaluate`] returns `undefined`. Playwright also supports transferring some additional values that are
+    # not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`.
     # 
     #
     # ```js
@@ -236,6 +293,16 @@ module Playwright
     # console.log(result); // prints "56"
     # ```
     # 
+    # ```python async
+    # result = await frame.evaluate("([x, y]) => Promise.resolve(x * y)", [7, 8])
+    # print(result) # prints "56"
+    # ```
+    # 
+    # ```python sync
+    # result = frame.evaluate("([x, y]) => Promise.resolve(x * y)", [7, 8])
+    # print(result) # prints "56"
+    # ```
+    # 
     # A string can also be passed in instead of a function.
     # 
     #
@@ -243,7 +310,19 @@ module Playwright
     # console.log(await frame.evaluate('1 + 2')); // prints "3"
     # ```
     # 
-    # `ElementHandle` instances can be passed as an argument to the `frame.evaluate`:
+    # ```python async
+    # print(await frame.evaluate("1 + 2")) # prints "3"
+    # x = 10
+    # print(await frame.evaluate(f"1 + {x}")) # prints "11"
+    # ```
+    # 
+    # ```python sync
+    # print(frame.evaluate("1 + 2")) # prints "3"
+    # x = 10
+    # print(frame.evaluate(f"1 + {x}")) # prints "11"
+    # ```
+    # 
+    # `ElementHandle` instances can be passed as an argument to the [`method: Frame.evaluate`]:
     # 
     #
     # ```js
@@ -251,17 +330,29 @@ module Playwright
     # const html = await frame.evaluate(([body, suffix]) => body.innerHTML + suffix, [bodyHandle, 'hello']);
     # await bodyHandle.dispose();
     # ```
-    def evaluate(pageFunction, arg: nil)
-      raise NotImplementedError.new('evaluate is not implemented yet.')
+    # 
+    # ```python async
+    # body_handle = await frame.query_selector("body")
+    # html = await frame.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])
+    # await body_handle.dispose()
+    # ```
+    # 
+    # ```python sync
+    # body_handle = frame.query_selector("body")
+    # html = frame.evaluate("([body, suffix]) => body.innerHTML + suffix", [body_handle, "hello"])
+    # body_handle.dispose()
+    # ```
+    def evaluate(expression, arg: nil)
+      wrap_impl(@impl.evaluate(unwrap_impl(expression), arg: unwrap_impl(arg)))
     end
 
-    # Returns the return value of `pageFunction` as in-page object (JSHandle).
+    # Returns the return value of `expression` as a `JSHandle`.
     # 
-    # The only difference between `frame.evaluate` and `frame.evaluateHandle` is that `frame.evaluateHandle` returns in-page
-    # object (JSHandle).
+    # The only difference between [`method: Frame.evaluate`] and [`method: Frame.evaluateHandle`] is that
+    # [method: Frame.evaluateHandle`] returns `JSHandle`.
     # 
-    # If the function, passed to the `frame.evaluateHandle`, returns a [Promise], then `frame.evaluateHandle` would wait for
-    # the promise to resolve and return its value.
+    # If the function, passed to the [`method: Frame.evaluateHandle`], returns a [Promise], then
+    # [`method: Frame.evaluateHandle`] would wait for the promise to resolve and return its value.
     # 
     #
     # ```js
@@ -269,6 +360,16 @@ module Playwright
     # aWindowHandle; // Handle for the window object.
     # ```
     # 
+    # ```python async
+    # a_window_handle = await frame.evaluate_handle("Promise.resolve(window)")
+    # a_window_handle # handle for the window object.
+    # ```
+    # 
+    # ```python sync
+    # a_window_handle = frame.evaluate_handle("Promise.resolve(window)")
+    # a_window_handle # handle for the window object.
+    # ```
+    # 
     # A string can also be passed in instead of a function.
     # 
     #
@@ -276,7 +377,15 @@ module Playwright
     # const aHandle = await frame.evaluateHandle('document'); // Handle for the 'document'.
     # ```
     # 
-    # `JSHandle` instances can be passed as an argument to the `frame.evaluateHandle`:
+    # ```python async
+    # a_handle = await page.evaluate_handle("document") # handle for the "document"
+    # ```
+    # 
+    # ```python sync
+    # a_handle = page.evaluate_handle("document") # handle for the "document"
+    # ```
+    # 
+    # `JSHandle` instances can be passed as an argument to the [`method: Frame.evaluateHandle`]:
     # 
     #
     # ```js
@@ -285,24 +394,39 @@ module Playwright
     # console.log(await resultHandle.jsonValue());
     # await resultHandle.dispose();
     # ```
-    def evaluate_handle(pageFunction, arg: nil)
-      raise NotImplementedError.new('evaluate_handle is not implemented yet.')
+    # 
+    # ```python async
+    # a_handle = await page.evaluate_handle("document.body")
+    # result_handle = await page.evaluate_handle("body => body.innerHTML", a_handle)
+    # print(await result_handle.json_value())
+    # await result_handle.dispose()
+    # ```
+    # 
+    # ```python sync
+    # a_handle = page.evaluate_handle("document.body")
+    # result_handle = page.evaluate_handle("body => body.innerHTML", a_handle)
+    # print(result_handle.json_value())
+    # result_handle.dispose()
+    # ```
+    def evaluate_handle(expression, arg: nil)
+      wrap_impl(@impl.evaluate_handle(unwrap_impl(expression), arg: unwrap_impl(arg)))
     end
 
     # This method waits for an element matching `selector`, waits for [actionability](./actionability.md) checks, focuses the
-    # element, fills it and triggers an `input` event after filling. If the element matching `selector` is not an `<input>`,
-    # `<textarea>` or `[contenteditable]` element, this method throws an error. Note that you can pass an empty string to
-    # clear the input field.
+    # element, fills it and triggers an `input` event after filling. If the element is inside the `<label>` element that has
+    # associated [control](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control), that control will be
+    # filled instead. If the element to be filled is not an `<input>`, `<textarea>` or `[contenteditable]` element, this
+    # method throws an error. Note that you can pass an empty string to clear the input field.
     # 
     # To send fine-grained keyboard events, use [`method: Frame.type`].
     def fill(selector, value, noWaitAfter: nil, timeout: nil)
-      raise NotImplementedError.new('fill is not implemented yet.')
+      wrap_impl(@impl.fill(unwrap_impl(selector), unwrap_impl(value), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     # This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method
     # waits until a matching element appears in the DOM.
     def focus(selector, timeout: nil)
-      raise NotImplementedError.new('focus is not implemented yet.')
+      wrap_impl(@impl.focus(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns the `frame` or `iframe` element handle which corresponds to this frame.
@@ -318,13 +442,25 @@ module Playwright
     # const contentFrame = await frameElement.contentFrame();
     # console.log(frame === contentFrame);  // -> true
     # ```
+    # 
+    # ```python async
+    # frame_element = await frame.frame_element()
+    # content_frame = await frame_element.content_frame()
+    # assert frame == content_frame
+    # ```
+    # 
+    # ```python sync
+    # frame_element = frame.frame_element()
+    # content_frame = frame_element.content_frame()
+    # assert frame == content_frame
+    # ```
     def frame_element
       raise NotImplementedError.new('frame_element is not implemented yet.')
     end
 
     # Returns element attribute value.
     def get_attribute(selector, name, timeout: nil)
-      raise NotImplementedError.new('get_attribute is not implemented yet.')
+      wrap_impl(@impl.get_attribute(unwrap_impl(selector), unwrap_impl(name), timeout: unwrap_impl(timeout)))
     end
 
     # Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
@@ -341,12 +477,12 @@ module Playwright
     # "Not Found" and 500 "Internal Server Error".  The status code for such responses can be retrieved by calling
     # [`method: Response.status`].
     # 
-    # > **NOTE** `frame.goto` either throws an error or returns a main resource response. The only exceptions are navigation
-    # to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
-    # > **NOTE** Headless mode doesn't support navigation to a PDF document. See the
+    # > NOTE: `frame.goto` either throws an error or returns a main resource response. The only exceptions are navigation to
+    # `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
+    # > NOTE: Headless mode doesn't support navigation to a PDF document. See the
     # [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
     def goto(url, referer: nil, timeout: nil, waitUntil: nil)
-      wrap_channel_owner(@channel_owner.goto(url, referer: referer, timeout: timeout, waitUntil: waitUntil))
+      wrap_impl(@impl.goto(unwrap_impl(url), referer: unwrap_impl(referer), timeout: unwrap_impl(timeout), waitUntil: unwrap_impl(waitUntil)))
     end
 
     # This method hovers over an element matching `selector` by performing the following steps:
@@ -365,72 +501,71 @@ module Playwright
           modifiers: nil,
           position: nil,
           timeout: nil)
-      raise NotImplementedError.new('hover is not implemented yet.')
+      wrap_impl(@impl.hover(unwrap_impl(selector), force: unwrap_impl(force), modifiers: unwrap_impl(modifiers), position: unwrap_impl(position), timeout: unwrap_impl(timeout)))
     end
 
     # Returns `element.innerHTML`.
     def inner_html(selector, timeout: nil)
-      raise NotImplementedError.new('inner_html is not implemented yet.')
+      wrap_impl(@impl.inner_html(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns `element.innerText`.
     def inner_text(selector, timeout: nil)
-      raise NotImplementedError.new('inner_text is not implemented yet.')
+      wrap_impl(@impl.inner_text(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
     def checked?(selector, timeout: nil)
-      raise NotImplementedError.new('checked? is not implemented yet.')
+      wrap_impl(@impl.checked?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns `true` if the frame has been detached, or `false` otherwise.
     def detached?
-      raise NotImplementedError.new('detached? is not implemented yet.')
+      wrap_impl(@impl.detached?)
     end
 
     # Returns whether the element is disabled, the opposite of [enabled](./actionability.md#enabled).
     def disabled?(selector, timeout: nil)
-      raise NotImplementedError.new('disabled? is not implemented yet.')
+      wrap_impl(@impl.disabled?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns whether the element is [editable](./actionability.md#editable).
     def editable?(selector, timeout: nil)
-      raise NotImplementedError.new('editable? is not implemented yet.')
+      wrap_impl(@impl.editable?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns whether the element is [enabled](./actionability.md#enabled).
     def enabled?(selector, timeout: nil)
-      raise NotImplementedError.new('enabled? is not implemented yet.')
+      wrap_impl(@impl.enabled?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns whether the element is hidden, the opposite of [visible](./actionability.md#visible).
     def hidden?(selector, timeout: nil)
-      raise NotImplementedError.new('hidden? is not implemented yet.')
+      wrap_impl(@impl.hidden?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns whether the element is [visible](./actionability.md#visible).
     def visible?(selector, timeout: nil)
-      raise NotImplementedError.new('visible? is not implemented yet.')
+      wrap_impl(@impl.visible?(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns frame's name attribute as specified in the tag.
     # 
     # If the name is empty, returns the id attribute instead.
     # 
-    # > **NOTE** This value is calculated once when the frame is created, and will not update if the attribute is changed
-    # later.
+    # > NOTE: This value is calculated once when the frame is created, and will not update if the attribute is changed later.
     def name
-      raise NotImplementedError.new('name is not implemented yet.')
+      wrap_impl(@impl.name)
     end
 
     # Returns the page containing this frame.
     def page
-      wrap_channel_owner(@channel_owner.page)
+      wrap_impl(@impl.page)
     end
 
     # Parent frame, if any. Detached frames and main frames return `null`.
     def parent_frame
-      raise NotImplementedError.new('parent_frame is not implemented yet.')
+      wrap_impl(@impl.parent_frame)
     end
 
     # `key` can specify the intended [keyboardEvent.key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)
@@ -455,7 +590,23 @@ module Playwright
           delay: nil,
           noWaitAfter: nil,
           timeout: nil)
-      raise NotImplementedError.new('press is not implemented yet.')
+      wrap_impl(@impl.press(unwrap_impl(selector), unwrap_impl(key), delay: unwrap_impl(delay), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
+    end
+
+    # Returns the ElementHandle pointing to the frame element.
+    # 
+    # The method finds an element matching the specified selector within the frame. See
+    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns `null`.
+    def query_selector(selector)
+      wrap_impl(@impl.query_selector(unwrap_impl(selector)))
+    end
+
+    # Returns the ElementHandles pointing to the frame elements.
+    # 
+    # The method finds all elements matching the specified selector within the frame. See
+    # [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns empty array.
+    def query_selector_all(selector)
+      wrap_impl(@impl.query_selector_all(unwrap_impl(selector)))
     end
 
     # Returns the array of option values that have been successfully selected.
@@ -463,6 +614,8 @@ module Playwright
     # Triggers a `change` and `input` event once all the provided options have been selected. If there's no `<select>` element
     # matching `selector`, the method throws an error.
     # 
+    # Will wait until all specified options are present in the `<select>` element.
+    # 
     #
     # ```js
     # // single selection matching the value
@@ -474,13 +627,32 @@ module Playwright
     # // multiple selection
     # frame.selectOption('select#colors', 'red', 'green', 'blue');
     # ```
+    # 
+    # ```python async
+    # # single selection matching the value
+    # await frame.select_option("select#colors", "blue")
+    # # single selection matching the label
+    # await frame.select_option("select#colors", label="blue")
+    # # multiple selection
+    # await frame.select_option("select#colors", value=["red", "green", "blue"])
+    # ```
+    # 
+    # ```python sync
+    # # single selection matching the value
+    # frame.select_option("select#colors", "blue")
+    # # single selection matching both the label
+    # frame.select_option("select#colors", label="blue")
+    # # multiple selection
+    # frame.select_option("select#colors", value=["red", "green", "blue"])
+    # ```
     def select_option(selector, values, noWaitAfter: nil, timeout: nil)
-      raise NotImplementedError.new('select_option is not implemented yet.')
+      wrap_impl(@impl.select_option(unwrap_impl(selector), unwrap_impl(values), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     def set_content(html, timeout: nil, waitUntil: nil)
-      raise NotImplementedError.new('set_content is not implemented yet.')
+      wrap_impl(@impl.set_content(unwrap_impl(html), timeout: unwrap_impl(timeout), waitUntil: unwrap_impl(waitUntil)))
     end
+    alias_method :content=, :set_content
 
     # This method expects `selector` to point to an
     # [input element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).
@@ -488,7 +660,7 @@ module Playwright
     # Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they
     # are resolved relative to the the current working directory. For empty array, clears the selected files.
     def set_input_files(selector, files, noWaitAfter: nil, timeout: nil)
-      raise NotImplementedError.new('set_input_files is not implemented yet.')
+      wrap_impl(@impl.set_input_files(unwrap_impl(selector), unwrap_impl(files), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     # This method taps an element matching `selector` by performing the following steps:
@@ -502,7 +674,7 @@ module Playwright
     # When all steps combined have not finished during the specified `timeout`, this method rejects with a `TimeoutError`.
     # Passing zero timeout disables this.
     # 
-    # > **NOTE** `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
+    # > NOTE: `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
     def tap_point(
           selector,
           force: nil,
@@ -510,17 +682,17 @@ module Playwright
           noWaitAfter: nil,
           position: nil,
           timeout: nil)
-      raise NotImplementedError.new('tap_point is not implemented yet.')
+      wrap_impl(@impl.tap_point(unwrap_impl(selector), force: unwrap_impl(force), modifiers: unwrap_impl(modifiers), noWaitAfter: unwrap_impl(noWaitAfter), position: unwrap_impl(position), timeout: unwrap_impl(timeout)))
     end
 
     # Returns `element.textContent`.
     def text_content(selector, timeout: nil)
-      raise NotImplementedError.new('text_content is not implemented yet.')
+      wrap_impl(@impl.text_content(unwrap_impl(selector), timeout: unwrap_impl(timeout)))
     end
 
     # Returns the page title.
     def title
-      raise NotImplementedError.new('title is not implemented yet.')
+      wrap_impl(@impl.title)
     end
 
     # Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character in the text. `frame.type` can be used to
@@ -533,13 +705,23 @@ module Playwright
     # await frame.type('#mytextarea', 'Hello'); // Types instantly
     # await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
     # ```
-    def type_text(
+    # 
+    # ```python async
+    # await frame.type("#mytextarea", "hello") # types instantly
+    # await frame.type("#mytextarea", "world", delay=100) # types slower, like a user
+    # ```
+    # 
+    # ```python sync
+    # frame.type("#mytextarea", "hello") # types instantly
+    # frame.type("#mytextarea", "world", delay=100) # types slower, like a user
+    # ```
+    def type(
           selector,
           text,
           delay: nil,
           noWaitAfter: nil,
           timeout: nil)
-      raise NotImplementedError.new('type_text is not implemented yet.')
+      wrap_impl(@impl.type(unwrap_impl(selector), unwrap_impl(text), delay: unwrap_impl(delay), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     # This method checks an element matching `selector` by performing the following steps:
@@ -556,17 +738,17 @@ module Playwright
     # When all steps combined have not finished during the specified `timeout`, this method rejects with a `TimeoutError`.
     # Passing zero timeout disables this.
     def uncheck(selector, force: nil, noWaitAfter: nil, timeout: nil)
-      raise NotImplementedError.new('uncheck is not implemented yet.')
+      wrap_impl(@impl.uncheck(unwrap_impl(selector), force: unwrap_impl(force), noWaitAfter: unwrap_impl(noWaitAfter), timeout: unwrap_impl(timeout)))
     end
 
     # Returns frame's url.
     def url
-      raise NotImplementedError.new('url is not implemented yet.')
+      wrap_impl(@impl.url)
     end
 
-    # Returns when the `pageFunction` returns a truthy value, returns that value.
+    # Returns when the `expression` returns a truthy value, returns that value.
     # 
-    # The `waitForFunction` can be used to observe viewport size change:
+    # The [`method: Frame.waitForFunction`] can be used to observe viewport size change:
     # 
     #
     # ```js
@@ -582,6 +764,39 @@ module Playwright
     # })();
     # ```
     # 
+    # ```python async
+    # import asyncio
+    # from playwright.async_api import async_playwright
+    # 
+    # async def run(playwright):
+    #     webkit = playwright.webkit
+    #     browser = await webkit.launch()
+    #     page = await browser.new_page()
+    #     await page.evaluate("window.x = 0; setTimeout(() => { window.x = 100 }, 1000);")
+    #     await page.main_frame.wait_for_function("() => window.x > 0")
+    #     await browser.close()
+    # 
+    # async def main():
+    #     async with async_playwright() as playwright:
+    #         await run(playwright)
+    # asyncio.run(main())
+    # ```
+    # 
+    # ```python sync
+    # 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.main_frame.wait_for_function("() => window.x > 0")
+    #     browser.close()
+    # 
+    # with sync_playwright() as playwright:
+    #     run(playwright)
+    # ```
+    # 
     # To pass an argument to the predicate of `frame.waitForFunction` function:
     # 
     #
@@ -589,8 +804,18 @@ module Playwright
     # const selector = '.foo';
     # await frame.waitForFunction(selector => !!document.querySelector(selector), selector);
     # ```
-    def wait_for_function(pageFunction, arg: nil, polling: nil, timeout: nil)
-      raise NotImplementedError.new('wait_for_function is not implemented yet.')
+    # 
+    # ```python async
+    # selector = ".foo"
+    # await frame.wait_for_function("selector => !!document.querySelector(selector)", selector)
+    # ```
+    # 
+    # ```python sync
+    # selector = ".foo"
+    # frame.wait_for_function("selector => !!document.querySelector(selector)", selector)
+    # ```
+    def wait_for_function(expression, arg: nil, polling: nil, timeout: nil)
+      wrap_impl(@impl.wait_for_function(unwrap_impl(expression), arg: unwrap_impl(arg), polling: unwrap_impl(polling), timeout: unwrap_impl(timeout)))
     end
 
     # Waits for the required load state to be reached.
@@ -603,13 +828,23 @@ module Playwright
     # await frame.click('button'); // Click triggers navigation.
     # await frame.waitForLoadState(); // Waits for 'load' state by default.
     # ```
+    # 
+    # ```python async
+    # await frame.click("button") # click triggers navigation.
+    # await frame.wait_for_load_state() # the promise resolves after "load" event.
+    # ```
+    # 
+    # ```python sync
+    # frame.click("button") # click triggers navigation.
+    # frame.wait_for_load_state() # the promise resolves after "load" event.
+    # ```
     def wait_for_load_state(state: nil, timeout: nil)
-      raise NotImplementedError.new('wait_for_load_state is not implemented yet.')
+      wrap_impl(@impl.wait_for_load_state(state: unwrap_impl(state), timeout: unwrap_impl(timeout)))
     end
 
-    # Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the
-    # last redirect. In case of navigation to a different anchor or navigation due to History API usage, the navigation will
-    # resolve with `null`.
+    # Waits for the frame navigation and returns the main resource response. In case of multiple redirects, the navigation
+    # will resolve with the response of the last redirect. In case of navigation to a different anchor or navigation due to
+    # History API usage, the navigation will resolve with `null`.
     # 
     # This method waits for the frame to navigate to a new URL. It is useful for when you run code which will indirectly cause
     # the frame to navigate. Consider this example:
@@ -617,15 +852,27 @@ module Playwright
     #
     # ```js
     # const [response] = await Promise.all([
-    #   frame.waitForNavigation(), // Wait for the navigation to finish
-    #   frame.click('a.my-link'), // Clicking the link will indirectly cause a navigation
+    #   frame.waitForNavigation(), // The promise resolves after navigation has finished
+    #   frame.click('a.delayed-navigation'), // Clicking the link will indirectly cause a navigation
     # ]);
     # ```
     # 
-    # **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is
+    # ```python async
+    # async with frame.expect_navigation():
+    #     await frame.click("a.delayed-navigation") # clicking the link will indirectly cause a navigation
+    # # Resolves after navigation has finished
+    # ```
+    # 
+    # ```python sync
+    # with frame.expect_navigation():
+    #     frame.click("a.delayed-navigation") # clicking the link will indirectly cause a navigation
+    # # 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.
-    def wait_for_navigation(timeout: nil, url: nil, waitUntil: nil)
-      raise NotImplementedError.new('wait_for_navigation is not implemented yet.')
+    def expect_navigation(timeout: nil, url: nil, waitUntil: nil, &block)
+      wrap_impl(@impl.expect_navigation(timeout: unwrap_impl(timeout), url: unwrap_impl(url), waitUntil: unwrap_impl(waitUntil), &wrap_block_call(block)))
     end
 
     # Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
@@ -639,23 +886,58 @@ module Playwright
     # 
     #
     # ```js
-    # const { webkit } = require('playwright');  // Or 'chromium' or 'firefox'.
+    # const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
     # 
     # (async () => {
-    #   const browser = await webkit.launch();
+    #   const browser = await chromium.launch();
     #   const page = await browser.newPage();
-    #   let currentURL;
-    #   page.mainFrame()
-    #     .waitForSelector('img')
-    #     .then(() => console.log('First URL with image: ' + currentURL));
-    #   for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
+    #   for (let currentURL of ['https://google.com', 'https://bbc.com']) {
     #     await page.goto(currentURL);
+    #     const element = await page.mainFrame().waitForSelector('img');
+    #     console.log('Loaded image: ' + await element.getAttribute('src'));
     #   }
     #   await browser.close();
     # })();
     # ```
+    # 
+    # ```python async
+    # import asyncio
+    # from playwright.async_api import async_playwright
+    # 
+    # async def run(playwright):
+    #     chromium = playwright.chromium
+    #     browser = await chromium.launch()
+    #     page = await browser.new_page()
+    #     for current_url in ["https://google.com", "https://bbc.com"]:
+    #         await page.goto(current_url, wait_until="domcontentloaded")
+    #         element = await page.main_frame.wait_for_selector("img")
+    #         print("Loaded image: " + str(await element.get_attribute("src")))
+    #     await browser.close()
+    # 
+    # async def main():
+    #     async with async_playwright() as playwright:
+    #         await run(playwright)
+    # asyncio.run(main())
+    # ```
+    # 
+    # ```python sync
+    # 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.main_frame.wait_for_selector("img")
+    #         print("Loaded image: " + str(element.get_attribute("src")))
+    #     browser.close()
+    # 
+    # with sync_playwright() as playwright:
+    #     run(playwright)
+    # ```
     def wait_for_selector(selector, state: nil, timeout: nil)
-      raise NotImplementedError.new('wait_for_selector is not implemented yet.')
+      wrap_impl(@impl.wait_for_selector(unwrap_impl(selector), state: unwrap_impl(state), timeout: unwrap_impl(timeout)))
     end
 
     # Waits for the given `timeout` in milliseconds.
@@ -666,9 +948,32 @@ module Playwright
       raise NotImplementedError.new('wait_for_timeout is not implemented yet.')
     end
 
+    # @nodoc
+    def detached=(req)
+      wrap_impl(@impl.detached=(unwrap_impl(req)))
+    end
+
     # @nodoc
     def after_initialize
-      wrap_channel_owner(@channel_owner.after_initialize)
+      wrap_impl(@impl.after_initialize)
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def on(event, callback)
+      wrap_impl(@impl.on(unwrap_impl(event), unwrap_impl(callback)))
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def off(event, callback)
+      wrap_impl(@impl.off(unwrap_impl(event), unwrap_impl(callback)))
+    end
+
+    # -- inherited from EventEmitter --
+    # @nodoc
+    def once(event, callback)
+      wrap_impl(@impl.once(unwrap_impl(event), unwrap_impl(callback)))
     end
   end
 end