playwright-ruby-client 0.0.4 → 0.0.9

data/lib/playwright_api/accessibility.rb

@@ -6,18 +6,18 @@ module Playwright
   # Accessibility is a very platform-specific thing. On different platforms, there are different screen readers that might
   # have wildly different output.
   # 
-  # Blink - Chromium's rendering engine - has a concept of "accessibility tree", which is then translated into different
-  # platform-specific APIs. Accessibility namespace gives users access to the Blink Accessibility Tree.
+  # Rendering engines of Chromium, Firefox and Webkit have a concept of "accessibility tree", which is then translated into
+  # different platform-specific APIs. Accessibility namespace gives access to this Accessibility Tree.
   # 
-  # Most of the accessibility tree gets filtered out when converting from Blink AX Tree to Platform-specific AX-Tree or by
-  # assistive technologies themselves. By default, Playwright tries to approximate this filtering, exposing only the
-  # "interesting" nodes of the tree.
+  # Most of the accessibility tree gets filtered out when converting from internal browser AX Tree to Platform-specific
+  # AX-Tree or by assistive technologies themselves. By default, Playwright tries to approximate this filtering, exposing
+  # only the "interesting" nodes of the tree.
   class Accessibility < PlaywrightApi
 
     # Captures the current state of the accessibility tree. The returned object represents the root accessible node of the
     # page.
     # 
-    # > **NOTE** The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen readers.
+    # > NOTE: The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen readers.
     # Playwright will discard them as well for an easier to process tree, unless `interestingOnly` is set to `false`.
     # 
     # An example of dumping the entire accessibility tree:
@@ -28,6 +28,16 @@ module Playwright
     # console.log(snapshot);
     # ```
     # 
+    # ```python async
+    # snapshot = await page.accessibility.snapshot()
+    # print(snapshot)
+    # ```
+    # 
+    # ```python sync
+    # snapshot = page.accessibility.snapshot()
+    # print(snapshot)
+    # ```
+    # 
     # An example of logging the focused node's name:
     # 
     #
@@ -46,6 +56,36 @@ module Playwright
     #   return null;
     # }
     # ```
+    # 
+    # ```python async
+    # def find_focused_node(node):
+    #     if (node.get("focused"))
+    #         return node
+    #     for child in (node.get("children") or []):
+    #         found_node = find_focused_node(child)
+    #         return found_node
+    #     return None
+    # 
+    # snapshot = await page.accessibility.snapshot()
+    # node = find_focused_node(snapshot)
+    # if node:
+    #     print(node["name"])
+    # ```
+    # 
+    # ```python sync
+    # def find_focused_node(node):
+    #     if (node.get("focused"))
+    #         return node
+    #     for child in (node.get("children") or []):
+    #         found_node = find_focused_node(child)
+    #         return found_node
+    #     return None
+    # 
+    # snapshot = page.accessibility.snapshot()
+    # node = find_focused_node(snapshot)
+    # if node:
+    #     print(node["name"])
+    # ```
     def snapshot(interestingOnly: nil, root: nil)
       raise NotImplementedError.new('snapshot is not implemented yet.')
     end

data/lib/playwright_api/android.rb

@@ -0,0 +1,33 @@
+module Playwright
+  # @nodoc
+  class Android < PlaywrightApi
+
+    # @nodoc
+    def after_initialize
+      wrap_impl(@impl.after_initialize)
+    end
+
+    # @nodoc
+    def devices
+      wrap_impl(@impl.devices)
+    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

data/lib/playwright_api/android_device.rb

@@ -0,0 +1,78 @@
+module Playwright
+  # @nodoc
+  class AndroidDevice < PlaywrightApi
+
+    # @nodoc
+    def tree
+      wrap_impl(@impl.tree)
+    end
+
+    # @nodoc
+    def close
+      wrap_impl(@impl.close)
+    end
+
+    # @nodoc
+    def shell(command)
+      wrap_impl(@impl.shell(unwrap_impl(command)))
+    end
+
+    # @nodoc
+    def after_initialize
+      wrap_impl(@impl.after_initialize)
+    end
+
+    # @nodoc
+    def tap_on(selector, duration: nil, timeout: nil)
+      wrap_impl(@impl.tap_on(unwrap_impl(selector), duration: unwrap_impl(duration), timeout: unwrap_impl(timeout)))
+    end
+
+    # @nodoc
+    def screenshot(path: nil)
+      wrap_impl(@impl.screenshot(path: unwrap_impl(path)))
+    end
+
+    # @nodoc
+    def input
+      wrap_impl(@impl.input)
+    end
+
+    # @nodoc
+    def launch_browser(pkg: nil, acceptDownloads: nil, bypassCSP: nil, colorScheme: nil, deviceScaleFactor: nil, extraHTTPHeaders: nil, geolocation: nil, hasTouch: nil, httpCredentials: nil, ignoreHTTPSErrors: nil, isMobile: nil, javaScriptEnabled: nil, locale: nil, logger: nil, offline: nil, permissions: nil, proxy: nil, recordHar: nil, recordVideo: nil, storageState: nil, timezoneId: nil, userAgent: nil, videoSize: nil, videosPath: nil, viewport: nil, &block)
+      wrap_impl(@impl.launch_browser(pkg: unwrap_impl(pkg), acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), logger: unwrap_impl(logger), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), recordHar: unwrap_impl(recordHar), recordVideo: unwrap_impl(recordVideo), storageState: unwrap_impl(storageState), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), videoSize: unwrap_impl(videoSize), videosPath: unwrap_impl(videosPath), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
+    end
+
+    # @nodoc
+    def info(selector)
+      wrap_impl(@impl.info(unwrap_impl(selector)))
+    end
+
+    # @nodoc
+    def serial
+      wrap_impl(@impl.serial)
+    end
+
+    # @nodoc
+    def model
+      wrap_impl(@impl.model)
+    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

data/lib/playwright_api/android_input.rb

@@ -0,0 +1,25 @@
+module Playwright
+  # @nodoc
+  class AndroidInput < PlaywrightApi
+
+    # @nodoc
+    def type(text)
+      wrap_impl(@impl.type(unwrap_impl(text)))
+    end
+
+    # @nodoc
+    def drag(from, to, steps)
+      wrap_impl(@impl.drag(unwrap_impl(from), unwrap_impl(to), unwrap_impl(steps)))
+    end
+
+    # @nodoc
+    def press(key)
+      wrap_impl(@impl.press(unwrap_impl(key)))
+    end
+
+    # @nodoc
+    def tap_point(point)
+      wrap_impl(@impl.tap_point(unwrap_impl(point)))
+    end
+  end
+end

data/lib/playwright_api/binding_call.rb

@@ -1,5 +1,23 @@
 module Playwright
   # @nodoc
   class BindingCall < PlaywrightApi
+
+    # -- 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

data/lib/playwright_api/browser.rb

@@ -1,7 +1,7 @@
 module Playwright
-  # - extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
+  # - extends: [EventEmitter]
   # 
-  # A Browser is created via [`method: BrowserType.launch`]. An example of using a `Browser` to create a [Page]:
+  # A Browser is created via [`method: BrowserType.launch`]. An example of using a `Browser` to create a `Page`:
   # 
   #
   # ```js
@@ -15,8 +15,36 @@ module Playwright
   # })();
   # ```
   # 
-  # See `ChromiumBrowser`, [FirefoxBrowser] and [WebKitBrowser] for browser-specific features. Note that
-  # [`method: BrowserType.launch`] always returns a specific browser instance, based on the browser being launched.
+  # ```python async
+  # import asyncio
+  # from playwright.async_api import async_playwright
+  # 
+  # async def run(playwright):
+  #     firefox = playwright.firefox
+  #     browser = await firefox.launch()
+  #     page = await browser.new_page()
+  #     await page.goto("https://example.com")
+  #     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):
+  #     firefox = playwright.firefox
+  #     browser = firefox.launch()
+  #     page = browser.new_page()
+  #     page.goto("https://example.com")
+  #     browser.close()
+  # 
+  # with sync_playwright() as playwright:
+  #     run(playwright)
+  # ```
   class Browser < PlaywrightApi
 
     # In case this browser is obtained using [`method: BrowserType.launch`], closes the browser and all of its pages (if any
@@ -27,7 +55,7 @@ module Playwright
     # 
     # The `Browser` object itself is considered to be disposed and cannot be used anymore.
     def close
-      wrap_channel_owner(@channel_owner.close)
+      wrap_impl(@impl.close)
     end
 
     # Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
@@ -40,13 +68,27 @@ module Playwright
     # const context = await browser.newContext();
     # console.log(browser.contexts().length); // prints `1`
     # ```
+    # 
+    # ```python async
+    # browser = await pw.webkit.launch()
+    # print(len(browser.contexts())) # prints `0`
+    # context = await browser.new_context()
+    # print(len(browser.contexts())) # prints `1`
+    # ```
+    # 
+    # ```python sync
+    # browser = pw.webkit.launch()
+    # print(len(browser.contexts())) # prints `0`
+    # context = browser.new_context()
+    # print(len(browser.contexts())) # prints `1`
+    # ```
     def contexts
-      wrap_channel_owner(@channel_owner.contexts)
+      wrap_impl(@impl.contexts)
     end
 
     # Indicates that the browser is connected.
     def connected?
-      wrap_channel_owner(@channel_owner.connected?)
+      wrap_impl(@impl.connected?)
     end
 
     # Creates a new browser context. It won't share cookies/cache with other browser contexts.
@@ -62,6 +104,24 @@ module Playwright
     #   await page.goto('https://example.com');
     # })();
     # ```
+    # 
+    # ```python async
+    # browser = await playwright.firefox.launch() # or "chromium" or "webkit".
+    # # create a new incognito browser context.
+    # context = await browser.new_context()
+    # # create a new page in a pristine context.
+    # page = await context.new_page()
+    # await page.goto("https://example.com")
+    # ```
+    # 
+    # ```python sync
+    # browser = playwright.firefox.launch() # or "chromium" or "webkit".
+    # # create a new incognito browser context.
+    # context = browser.new_context()
+    # # create a new page in a pristine context.
+    # page = context.new_page()
+    # page.goto("https://example.com")
+    # ```
     def new_context(
           acceptDownloads: nil,
           bypassCSP: nil,
@@ -82,12 +142,14 @@ module Playwright
           recordHar: nil,
           recordVideo: nil,
           storageState: nil,
+          storageStatePath: nil,
           timezoneId: nil,
           userAgent: nil,
           videoSize: nil,
           videosPath: nil,
-          viewport: nil)
-      wrap_channel_owner(@channel_owner.new_context(acceptDownloads: acceptDownloads, bypassCSP: bypassCSP, colorScheme: colorScheme, deviceScaleFactor: deviceScaleFactor, extraHTTPHeaders: extraHTTPHeaders, geolocation: geolocation, hasTouch: hasTouch, httpCredentials: httpCredentials, ignoreHTTPSErrors: ignoreHTTPSErrors, isMobile: isMobile, javaScriptEnabled: javaScriptEnabled, locale: locale, logger: logger, offline: offline, permissions: permissions, proxy: proxy, recordHar: recordHar, recordVideo: recordVideo, storageState: storageState, timezoneId: timezoneId, userAgent: userAgent, videoSize: videoSize, videosPath: videosPath, viewport: viewport))
+          viewport: nil,
+          &block)
+      wrap_impl(@impl.new_context(acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), logger: unwrap_impl(logger), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), recordHar: unwrap_impl(recordHar), recordVideo: unwrap_impl(recordVideo), storageState: unwrap_impl(storageState), storageStatePath: unwrap_impl(storageStatePath), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), videoSize: unwrap_impl(videoSize), videosPath: unwrap_impl(videosPath), viewport: unwrap_impl(viewport), &wrap_block_call(block)))
     end
 
     # Creates a new page in a new browser context. Closing this page will close the context as well.
@@ -115,22 +177,41 @@ module Playwright
           recordHar: nil,
           recordVideo: nil,
           storageState: nil,
+          storageStatePath: nil,
           timezoneId: nil,
           userAgent: nil,
           videoSize: nil,
           videosPath: nil,
           viewport: nil)
-      wrap_channel_owner(@channel_owner.new_page(acceptDownloads: acceptDownloads, bypassCSP: bypassCSP, colorScheme: colorScheme, deviceScaleFactor: deviceScaleFactor, extraHTTPHeaders: extraHTTPHeaders, geolocation: geolocation, hasTouch: hasTouch, httpCredentials: httpCredentials, ignoreHTTPSErrors: ignoreHTTPSErrors, isMobile: isMobile, javaScriptEnabled: javaScriptEnabled, locale: locale, logger: logger, offline: offline, permissions: permissions, proxy: proxy, recordHar: recordHar, recordVideo: recordVideo, storageState: storageState, timezoneId: timezoneId, userAgent: userAgent, videoSize: videoSize, videosPath: videosPath, viewport: viewport))
+      wrap_impl(@impl.new_page(acceptDownloads: unwrap_impl(acceptDownloads), bypassCSP: unwrap_impl(bypassCSP), colorScheme: unwrap_impl(colorScheme), deviceScaleFactor: unwrap_impl(deviceScaleFactor), extraHTTPHeaders: unwrap_impl(extraHTTPHeaders), geolocation: unwrap_impl(geolocation), hasTouch: unwrap_impl(hasTouch), httpCredentials: unwrap_impl(httpCredentials), ignoreHTTPSErrors: unwrap_impl(ignoreHTTPSErrors), isMobile: unwrap_impl(isMobile), javaScriptEnabled: unwrap_impl(javaScriptEnabled), locale: unwrap_impl(locale), logger: unwrap_impl(logger), offline: unwrap_impl(offline), permissions: unwrap_impl(permissions), proxy: unwrap_impl(proxy), recordHar: unwrap_impl(recordHar), recordVideo: unwrap_impl(recordVideo), storageState: unwrap_impl(storageState), storageStatePath: unwrap_impl(storageStatePath), timezoneId: unwrap_impl(timezoneId), userAgent: unwrap_impl(userAgent), videoSize: unwrap_impl(videoSize), videosPath: unwrap_impl(videosPath), viewport: unwrap_impl(viewport)))
     end
 
     # Returns the browser version.
     def version
-      wrap_channel_owner(@channel_owner.version)
+      wrap_impl(@impl.version)
     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

data/lib/playwright_api/browser_context.rb

@@ -1,5 +1,5 @@
 module Playwright
-  # - extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
+  # - extends: [EventEmitter]
   # 
   # BrowserContexts provide a way to operate multiple independent browser sessions.
   # 
@@ -19,6 +19,26 @@ module Playwright
   # // Dispose context once it's no longer needed.
   # await context.close();
   # ```
+  # 
+  # ```python async
+  # # create a new incognito browser context
+  # context = await browser.new_context()
+  # # create a new page inside context.
+  # page = await context.new_page()
+  # await page.goto("https://example.com")
+  # # dispose context once it"s no longer needed.
+  # await context.close()
+  # ```
+  # 
+  # ```python sync
+  # # create a new incognito browser context
+  # context = browser.new_context()
+  # # create a new page inside context.
+  # page = context.new_page()
+  # page.goto("https://example.com")
+  # # dispose context once it"s no longer needed.
+  # context.close()
+  # ```
   class BrowserContext < PlaywrightApi
 
     # Adds cookies into this browser context. All pages within this context will have these cookies installed. Cookies can be
@@ -28,6 +48,14 @@ module Playwright
     # ```js
     # await browserContext.addCookies([cookieObject1, cookieObject2]);
     # ```
+    # 
+    # ```python async
+    # await browser_context.add_cookies([cookie_object1, cookie_object2])
+    # ```
+    # 
+    # ```python sync
+    # browser_context.add_cookies([cookie_object1, cookie_object2])
+    # ```
     def add_cookies(cookies)
       raise NotImplementedError.new('add_cookies is not implemented yet.')
     end
@@ -43,7 +71,7 @@ module Playwright
     # An example of overriding `Math.random` before the page loads:
     # 
     #
-    # ```js
+    # ```js browser
     # // preload.js
     # Math.random = () => 42;
     # ```
@@ -56,7 +84,17 @@ module Playwright
     # });
     # ```
     # 
-    # > **NOTE** The order of evaluation of multiple scripts installed via [`method: BrowserContext.addInitScript`] and
+    # ```python async
+    # # in your playwright script, assuming the preload.js file is in same directory.
+    # await browser_context.add_init_script(path="preload.js")
+    # ```
+    # 
+    # ```python sync
+    # # in your playwright script, assuming the preload.js file is in same directory.
+    # browser_context.add_init_script(path="preload.js")
+    # ```
+    # 
+    # > NOTE: The order of evaluation of multiple scripts installed via [`method: BrowserContext.addInitScript`] and
     # [`method: Page.addInitScript`] is not defined.
     def add_init_script(script, arg: nil)
       raise NotImplementedError.new('add_init_script is not implemented yet.')
@@ -81,15 +119,29 @@ module Playwright
     # // do stuff ..
     # context.clearPermissions();
     # ```
+    # 
+    # ```python async
+    # context = await browser.new_context()
+    # await context.grant_permissions(["clipboard-read"])
+    # # do stuff ..
+    # context.clear_permissions()
+    # ```
+    # 
+    # ```python sync
+    # context = browser.new_context()
+    # context.grant_permissions(["clipboard-read"])
+    # # do stuff ..
+    # context.clear_permissions()
+    # ```
     def clear_permissions
       raise NotImplementedError.new('clear_permissions is not implemented yet.')
     end
 
     # Closes the browser context. All the pages that belong to the browser context will be closed.
     # 
-    # > **NOTE** the default browser context cannot be closed.
+    # > NOTE: The default browser context cannot be closed.
     def close
-      raise NotImplementedError.new('close is not implemented yet.')
+      wrap_impl(@impl.close)
     end
 
     # If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
@@ -131,6 +183,57 @@ module Playwright
     # })();
     # ```
     # 
+    # ```python async
+    # import asyncio
+    # from playwright.async_api import async_playwright
+    # 
+    # async def run(playwright):
+    #     webkit = playwright.webkit
+    #     browser = await webkit.launch(headless=false)
+    #     context = await browser.new_context()
+    #     await context.expose_binding("pageURL", lambda source: source["page"].url)
+    #     page = await context.new_page()
+    #     await page.set_content("""
+    #     <script>
+    #       async function onClick() {
+    #         document.querySelector('div').textContent = await window.pageURL();
+    #       }
+    #     </script>
+    #     <button onclick="onClick()">Click me</button>
+    #     <div></div>
+    #     """)
+    #     await page.click("button")
+    # 
+    # 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(headless=false)
+    #     context = browser.new_context()
+    #     context.expose_binding("pageURL", lambda source: source["page"].url)
+    #     page = context.new_page()
+    #     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)
+    # ```
+    # 
     # An example of passing an element handle:
     # 
     #
@@ -146,6 +249,34 @@ module Playwright
     #   <div>Or click me</div>
     # `);
     # ```
+    # 
+    # ```python async
+    # async def print(source, element):
+    #     print(await element.text_content())
+    # 
+    # await context.expose_binding("clicked", print, handle=true)
+    # await page.set_content("""
+    #   <script>
+    #     document.addEventListener('click', event => window.clicked(event.target));
+    #   </script>
+    #   <div>Click me</div>
+    #   <div>Or click me</div>
+    # """)
+    # ```
+    # 
+    # ```python sync
+    # def print(source, element):
+    #     print(element.text_content())
+    # 
+    # context.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>
+    # """)
+    # ```
     def expose_binding(name, callback, handle: nil)
       raise NotImplementedError.new('expose_binding is not implemented yet.')
     end
@@ -181,6 +312,72 @@ module Playwright
     #   await page.click('button');
     # })();
     # ```
+    # 
+    # ```python async
+    # import asyncio
+    # import hashlib
+    # from playwright.async_api import async_playwright
+    # 
+    # async def sha1(text):
+    #     m = hashlib.sha1()
+    #     m.update(bytes(text, "utf8"))
+    #     return m.hexdigest()
+    # 
+    # 
+    # async def run(playwright):
+    #     webkit = playwright.webkit
+    #     browser = await webkit.launch(headless=False)
+    #     context = await browser.new_context()
+    #     await context.expose_function("sha1", sha1)
+    #     page = await context.new_page()
+    #     await page.set_content("""
+    #         <script>
+    #           async function onClick() {
+    #             document.querySelector('div').textContent = await window.sha1('PLAYWRIGHT');
+    #           }
+    #         </script>
+    #         <button onclick="onClick()">Click me</button>
+    #         <div></div>
+    #     """)
+    #     await page.click("button")
+    # 
+    # async def main():
+    #     async with async_playwright() as playwright:
+    #         await run(playwright)
+    # asyncio.run(main())
+    # ```
+    # 
+    # ```python sync
+    # import hashlib
+    # from playwright.sync_api import sync_playwright
+    # 
+    # 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)
+    #     context = browser.new_context()
+    #     context.expose_function("sha1", sha1)
+    #     page = context.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")
+    # 
+    # with sync_playwright() as playwright:
+    #     run(playwright)
+    # ```
     def expose_function(name, callback)
       raise NotImplementedError.new('expose_function is not implemented yet.')
     end
@@ -193,13 +390,13 @@ module Playwright
 
     # Creates a new page in the browser context.
     def new_page
-      wrap_channel_owner(@channel_owner.new_page)
+      wrap_impl(@impl.new_page)
     end
 
     # Returns all open pages in the context. Non visible pages, such as `"background_page"`, will not be listed here. You can
     # find them using [`method: ChromiumBrowserContext.backgroundPages`].
     def pages
-      raise NotImplementedError.new('pages is not implemented yet.')
+      wrap_impl(@impl.pages)
     end
 
     # Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
@@ -216,6 +413,22 @@ module Playwright
     # await browser.close();
     # ```
     # 
+    # ```python async
+    # context = await browser.new_context()
+    # page = await context.new_page()
+    # await context.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())
+    # await page.goto("https://example.com")
+    # await browser.close()
+    # ```
+    # 
+    # ```python sync
+    # context = browser.new_context()
+    # page = context.new_page()
+    # context.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())
+    # page.goto("https://example.com")
+    # browser.close()
+    # ```
+    # 
     # or the same snippet using a regex pattern instead:
     # 
     #
@@ -227,10 +440,29 @@ module Playwright
     # await browser.close();
     # ```
     # 
+    # ```python async
+    # context = await browser.new_context()
+    # page = await context.new_page()
+    # await context.route(re.compile(r"(\.png$)|(\.jpg$)"), lambda route: route.abort())
+    # page = await context.new_page()
+    # await page.goto("https://example.com")
+    # await browser.close()
+    # ```
+    # 
+    # ```python sync
+    # context = browser.new_context()
+    # page = context.new_page()
+    # context.route(re.compile(r"(\.png$)|(\.jpg$)"), lambda route: route.abort())
+    # page = await context.new_page()
+    # page = context.new_page()
+    # page.goto("https://example.com")
+    # browser.close()
+    # ```
+    # 
     # Page routes (set up with [`method: Page.route`]) take precedence over browser context routes when request matches both
     # handlers.
     # 
-    # > **NOTE** Enabling routing disables http cache.
+    # > NOTE: Enabling routing disables http cache.
     def route(url, handler)
       raise NotImplementedError.new('route is not implemented yet.')
     end
@@ -243,7 +475,7 @@ module Playwright
     # - [`method: Page.setContent`]
     # - [`method: Page.waitForNavigation`]
     # 
-    # > **NOTE** [`method: Page.setDefaultNavigationTimeout`] and [`method: Page.setDefaultTimeout`] take priority over
+    # > NOTE: [`method: Page.setDefaultNavigationTimeout`] and [`method: Page.setDefaultTimeout`] take priority over
     # [`method: BrowserContext.setDefaultNavigationTimeout`].
     def set_default_navigation_timeout(timeout)
       raise NotImplementedError.new('set_default_navigation_timeout is not implemented yet.')
@@ -252,7 +484,7 @@ module Playwright
 
     # This setting will change the default maximum time for all the methods accepting `timeout` option.
     # 
-    # > **NOTE** [`method: Page.setDefaultNavigationTimeout`], [`method: Page.setDefaultTimeout`] and
+    # > NOTE: [`method: Page.setDefaultNavigationTimeout`], [`method: Page.setDefaultTimeout`] and
     # [`method: BrowserContext.setDefaultNavigationTimeout`] take priority over [`method: BrowserContext.setDefaultTimeout`].
     def set_default_timeout(timeout)
       raise NotImplementedError.new('set_default_timeout is not implemented yet.')
@@ -263,7 +495,7 @@ module Playwright
     # with page-specific extra HTTP headers set with [`method: Page.setExtraHTTPHeaders`]. If page overrides a particular
     # header, page-specific header value will be used instead of the browser context header value.
     # 
-    # > **NOTE** `browserContext.setExtraHTTPHeaders` does not guarantee the order of headers in the outgoing requests.
+    # > NOTE: [`method: BrowserContext.setExtraHTTPHeaders`] does not guarantee the order of headers in the outgoing requests.
     def set_extra_http_headers(headers)
       raise NotImplementedError.new('set_extra_http_headers is not implemented yet.')
     end
@@ -276,8 +508,16 @@ module Playwright
     # await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667});
     # ```
     # 
-    # > **NOTE** Consider using [`method: BrowserContext.grantPermissions`] to grant permissions for the browser context pages
-    # to read its geolocation.
+    # ```python async
+    # await browser_context.set_geolocation({"latitude": 59.95, "longitude": 30.31667})
+    # ```
+    # 
+    # ```python sync
+    # browser_context.set_geolocation({"latitude": 59.95, "longitude": 30.31667})
+    # ```
+    # 
+    # > NOTE: Consider using [`method: BrowserContext.grantPermissions`] to grant permissions for the browser context pages to
+    # read its geolocation.
     def set_geolocation(geolocation)
       raise NotImplementedError.new('set_geolocation is not implemented yet.')
     end
@@ -305,31 +545,42 @@ module Playwright
       raise NotImplementedError.new('unroute is not implemented yet.')
     end
 
-    # 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 context closes before the event is fired. Returns the event data value.
-    # 
-    #
-    # ```js
-    # const context = await browser.newContext();
-    # await context.grantPermissions(['geolocation']);
-    # ```
-    def wait_for_event(event, optionsOrPredicate: nil)
-      raise NotImplementedError.new('wait_for_event is not implemented yet.')
+    # @nodoc
+    def after_initialize
+      wrap_impl(@impl.after_initialize)
     end
 
     # @nodoc
-    def owner_page=(req)
-      wrap_channel_owner(@channel_owner.owner_page=(req))
+    def browser=(req)
+      wrap_impl(@impl.browser=(unwrap_impl(req)))
     end
 
     # @nodoc
-    def browser=(req)
-      wrap_channel_owner(@channel_owner.browser=(req))
+    def owner_page=(req)
+      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
     end
 
     # @nodoc
     def options=(req)
-      wrap_channel_owner(@channel_owner.options=(req))
+      wrap_impl(@impl.options=(unwrap_impl(req)))
+    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