playwright-ruby-client 0.1.0 → 0.5.3

data/lib/playwright_api/browser_context.rb

@@ -20,6 +20,16 @@ module Playwright
   # await context.close();
   # ```
   # 
+  # ```java
+  # // Create a new incognito browser context
+  # BrowserContext context = browser.newContext();
+  # // Create a new page inside context.
+  # Page page = context.newPage();
+  # page.navigate("https://example.com");
+  # // Dispose context once it"s no longer needed.
+  # context.close();
+  # ```
+  # 
   # ```python async
   # # create a new incognito browser context
   # context = await browser.new_context()
@@ -49,6 +59,10 @@ module Playwright
     # await browserContext.addCookies([cookieObject1, cookieObject2]);
     # ```
     # 
+    # ```java
+    # browserContext.addCookies(Arrays.asList(cookieObject1, cookieObject2));
+    # ```
+    # 
     # ```python async
     # await browser_context.add_cookies([cookie_object1, cookie_object2])
     # ```
@@ -57,7 +71,7 @@ module Playwright
     # browser_context.add_cookies([cookie_object1, cookie_object2])
     # ```
     def add_cookies(cookies)
-      raise NotImplementedError.new('add_cookies is not implemented yet.')
+      wrap_impl(@impl.add_cookies(unwrap_impl(cookies)))
     end
 
     # Adds a script which would be evaluated in one of the following scenarios:
@@ -84,6 +98,11 @@ module Playwright
     # });
     # ```
     # 
+    # ```java
+    # // In your playwright script, assuming the preload.js file is in same directory.
+    # browserContext.addInitScript(Paths.get("preload.js"));
+    # ```
+    # 
     # ```python async
     # # in your playwright script, assuming the preload.js file is in same directory.
     # await browser_context.add_init_script(path="preload.js")
@@ -96,18 +115,25 @@ module Playwright
     # 
     # > 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.')
+    def add_init_script(path: nil, script: nil)
+      wrap_impl(@impl.add_init_script(path: unwrap_impl(path), script: unwrap_impl(script)))
+    end
+
+    # > NOTE: Background pages are only supported on Chromium-based browsers.
+    # 
+    # All existing background pages in the context.
+    def background_pages
+      raise NotImplementedError.new('background_pages is not implemented yet.')
     end
 
     # Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
     def browser
-      raise NotImplementedError.new('browser is not implemented yet.')
+      wrap_impl(@impl.browser)
     end
 
     # Clears context cookies.
     def clear_cookies
-      raise NotImplementedError.new('clear_cookies is not implemented yet.')
+      wrap_impl(@impl.clear_cookies)
     end
 
     # Clears all permission overrides for the browser context.
@@ -120,6 +146,13 @@ module Playwright
     # context.clearPermissions();
     # ```
     # 
+    # ```java
+    # BrowserContext context = browser.newContext();
+    # context.grantPermissions(Arrays.asList("clipboard-read"));
+    # // do stuff ..
+    # context.clearPermissions();
+    # ```
+    # 
     # ```python async
     # context = await browser.new_context()
     # await context.grant_permissions(["clipboard-read"])
@@ -134,7 +167,7 @@ module Playwright
     # context.clear_permissions()
     # ```
     def clear_permissions
-      raise NotImplementedError.new('clear_permissions is not implemented yet.')
+      wrap_impl(@impl.clear_permissions)
     end
 
     # Closes the browser context. All the pages that belong to the browser context will be closed.
@@ -147,7 +180,7 @@ module Playwright
     # If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
     # are returned.
     def cookies(urls: nil)
-      raise NotImplementedError.new('cookies is not implemented yet.')
+      wrap_impl(@impl.cookies(urls: unwrap_impl(urls)))
     end
 
     # The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -183,6 +216,30 @@ module Playwright
     # })();
     # ```
     # 
+    # ```java
+    # import com.microsoft.playwright.*;
+    # 
+    # public class Example {
+    #   public static void main(String[] args) {
+    #     try (Playwright playwright = Playwright.create()) {
+    #       BrowserType webkit = playwright.webkit()
+    #       Browser browser = webkit.launch(new BrowserType.LaunchOptions().setHeadless(false));
+    #       BrowserContext context = browser.newContext();
+    #       context.exposeBinding("pageURL", (source, args) -> source.page().url());
+    #       Page page = context.newPage();
+    #       page.setContent("<script>\n" +
+    #         "  async function onClick() {\n" +
+    #         "    document.querySelector('div').textContent = await window.pageURL();\n" +
+    #         "  }\n" +
+    #         "</script>\n" +
+    #         "<button onclick=\"onClick()\">Click me</button>\n" +
+    #         "<div></div>");
+    #       page.click("button");
+    #     }
+    #   }
+    # }
+    # ```
+    # 
     # ```python async
     # import asyncio
     # from playwright.async_api import async_playwright
@@ -250,6 +307,20 @@ module Playwright
     # `);
     # ```
     # 
+    # ```java
+    # context.exposeBinding("clicked", (source, args) -> {
+    #   ElementHandle element = (ElementHandle) args[0];
+    #   System.out.println(element.textContent());
+    #   return null;
+    # }, new BrowserContext.ExposeBindingOptions().setHandle(true));
+    # page.setContent("" +
+    #   "<script>\n" +
+    #   "  document.addEventListener('click', event => window.clicked(event.target));\n" +
+    #   "</script>\n" +
+    #   "<div>Click me</div>\n" +
+    #   "<div>Or click me</div>\n");
+    # ```
+    # 
     # ```python async
     # async def print(source, element):
     #     print(await element.text_content())
@@ -278,7 +349,7 @@ module Playwright
     # """)
     # ```
     def expose_binding(name, callback, handle: nil)
-      raise NotImplementedError.new('expose_binding is not implemented yet.')
+      wrap_impl(@impl.expose_binding(unwrap_impl(name), unwrap_impl(callback), handle: unwrap_impl(handle)))
     end
 
     # The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -313,6 +384,44 @@ module Playwright
     # })();
     # ```
     # 
+    # ```java
+    # import com.microsoft.playwright.*;
+    # 
+    # import java.nio.charset.StandardCharsets;
+    # import java.security.MessageDigest;
+    # import java.security.NoSuchAlgorithmException;
+    # import java.util.Base64;
+    # 
+    # public class Example {
+    #   public static void main(String[] args) {
+    #     try (Playwright playwright = Playwright.create()) {
+    #       BrowserType webkit = playwright.webkit()
+    #       Browser browser = webkit.launch(new BrowserType.LaunchOptions().setHeadless(false));
+    #       context.exposeFunction("sha1", args -> {
+    #         String text = (String) args[0];
+    #         MessageDigest crypto;
+    #         try {
+    #           crypto = MessageDigest.getInstance("SHA-1");
+    #         } catch (NoSuchAlgorithmException e) {
+    #           return null;
+    #         }
+    #         byte[] token = crypto.digest(text.getBytes(StandardCharsets.UTF_8));
+    #         return Base64.getEncoder().encodeToString(token);
+    #       });
+    #       Page page = context.newPage();
+    #       page.setContent("<script>\n" +
+    #         "  async function onClick() {\n" +
+    #         "    document.querySelector('div').textContent = await window.sha1('PLAYWRIGHT');\n" +
+    #         "  }\n" +
+    #         "</script>\n" +
+    #         "<button onclick=\"onClick()\">Click me</button>\n" +
+    #         "<div></div>\n");
+    #       page.click("button");
+    #     }
+    #   }
+    # }
+    # ```
+    # 
     # ```python async
     # import asyncio
     # import hashlib
@@ -379,13 +488,20 @@ module Playwright
     #     run(playwright)
     # ```
     def expose_function(name, callback)
-      raise NotImplementedError.new('expose_function is not implemented yet.')
+      wrap_impl(@impl.expose_function(unwrap_impl(name), unwrap_impl(callback)))
     end
 
     # Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if
     # specified.
     def grant_permissions(permissions, origin: nil)
-      raise NotImplementedError.new('grant_permissions is not implemented yet.')
+      wrap_impl(@impl.grant_permissions(unwrap_impl(permissions), origin: unwrap_impl(origin)))
+    end
+
+    # > NOTE: CDP sessions are only supported on Chromium-based browsers.
+    # 
+    # Returns the newly created session.
+    def new_cdp_session(page)
+      raise NotImplementedError.new('new_cdp_session is not implemented yet.')
     end
 
     # Creates a new page in the browser context.
@@ -393,8 +509,7 @@ module Playwright
       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`].
+    # Returns all open pages in the context.
     def pages
       wrap_impl(@impl.pages)
     end
@@ -402,7 +517,7 @@ module Playwright
     # Routing provides the capability to modify network requests that are made by any page in the browser context. Once route
     # is enabled, every request matching the url pattern will stall unless it's continued, fulfilled or aborted.
     # 
-    # An example of a naïve handler that aborts all image requests:
+    # An example of a naive handler that aborts all image requests:
     # 
     #
     # ```js
@@ -413,6 +528,14 @@ module Playwright
     # await browser.close();
     # ```
     # 
+    # ```java
+    # BrowserContext context = browser.newContext();
+    # context.route("**/*.{png,jpg,jpeg}", route -> route.abort());
+    # Page page = context.newPage();
+    # page.navigate("https://example.com");
+    # browser.close();
+    # ```
+    # 
     # ```python async
     # context = await browser.new_context()
     # page = await context.new_page()
@@ -440,6 +563,14 @@ module Playwright
     # await browser.close();
     # ```
     # 
+    # ```java
+    # BrowserContext context = browser.newContext();
+    # context.route(Pattern.compile("(\\.png$)|(\\.jpg$)"), route -> route.abort());
+    # Page page = context.newPage();
+    # page.navigate("https://example.com");
+    # browser.close();
+    # ```
+    # 
     # ```python async
     # context = await browser.new_context()
     # page = await context.new_page()
@@ -462,9 +593,18 @@ module Playwright
     # Page routes (set up with [`method: Page.route`]) take precedence over browser context routes when request matches both
     # handlers.
     # 
+    # To remove a route with its handler you can use [`method: BrowserContext.unroute`].
+    # 
     # > NOTE: Enabling routing disables http cache.
     def route(url, handler)
-      raise NotImplementedError.new('route is not implemented yet.')
+      wrap_impl(@impl.route(unwrap_impl(url), unwrap_impl(handler)))
+    end
+
+    # > NOTE: Service workers are only supported on Chromium-based browsers.
+    # 
+    # All existing service workers in the context.
+    def service_workers
+      raise NotImplementedError.new('service_workers is not implemented yet.')
     end
 
     # This setting will change the default maximum navigation time for the following methods and related shortcuts:
@@ -478,7 +618,7 @@ module Playwright
     # > 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.')
+      wrap_impl(@impl.set_default_navigation_timeout(unwrap_impl(timeout)))
     end
     alias_method :default_navigation_timeout=, :set_default_navigation_timeout
 
@@ -487,7 +627,7 @@ module Playwright
     # > 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.')
+      wrap_impl(@impl.set_default_timeout(unwrap_impl(timeout)))
     end
     alias_method :default_timeout=, :set_default_timeout
 
@@ -497,7 +637,7 @@ module Playwright
     # 
     # > 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.')
+      wrap_impl(@impl.set_extra_http_headers(unwrap_impl(headers)))
     end
     alias_method :extra_http_headers=, :set_extra_http_headers
 
@@ -508,6 +648,10 @@ module Playwright
     # await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667});
     # ```
     # 
+    # ```java
+    # browserContext.setGeolocation(new Geolocation(59.95, 30.31667));
+    # ```
+    # 
     # ```python async
     # await browser_context.set_geolocation({"latitude": 59.95, "longitude": 30.31667})
     # ```
@@ -519,18 +663,12 @@ module Playwright
     # > 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.')
+      wrap_impl(@impl.set_geolocation(unwrap_impl(geolocation)))
     end
     alias_method :geolocation=, :set_geolocation
 
-    # **DEPRECATED** Browsers may cache credentials after successful authentication. Create a new browser context instead.
-    def set_http_credentials(httpCredentials)
-      raise NotImplementedError.new('set_http_credentials is not implemented yet.')
-    end
-    alias_method :http_credentials=, :set_http_credentials
-
     def set_offline(offline)
-      raise NotImplementedError.new('set_offline is not implemented yet.')
+      wrap_impl(@impl.set_offline(unwrap_impl(offline)))
     end
     alias_method :offline=, :set_offline
 
@@ -542,12 +680,58 @@ module Playwright
     # Removes a route created with [`method: BrowserContext.route`]. When `handler` is not specified, removes all routes for
     # the `url`.
     def unroute(url, handler: nil)
-      raise NotImplementedError.new('unroute is not implemented yet.')
+      wrap_impl(@impl.unroute(unwrap_impl(url), handler: unwrap_impl(handler)))
+    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 [page, _] = await Promise.all([
+    #   context.waitForEvent('page'),
+    #   page.click('button')
+    # ]);
+    # ```
+    # 
+    # ```java
+    # Page newPage = context.waitForPage(() -> page.click("button"));
+    # ```
+    # 
+    # ```python async
+    # async with context.expect_event("page") as event_info:
+    #     await page.click("button")
+    # page = await event_info.value
+    # ```
+    # 
+    # ```python sync
+    # with context.expect_event("page") as event_info:
+    #     page.click("button")
+    # page = event_info.value
+    # ```
+    def expect_event(event, predicate: nil, timeout: nil, &block)
+      wrap_impl(@impl.expect_event(unwrap_impl(event), predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
+    end
+
+    # Performs action and waits for a new `Page` to be created in the context. If predicate is provided, it passes `Page`
+    # value into the `predicate` function and waits for `predicate(event)` to return a truthy value. Will throw an error if
+    # the context closes before new `Page` is created.
+    def expect_page(predicate: nil, timeout: nil)
+      wrap_impl(@impl.expect_page(predicate: unwrap_impl(predicate), timeout: unwrap_impl(timeout)))
+    end
+
+    # > NOTE: In most cases, you should use [`method: BrowserContext.waitForEvent`].
+    # 
+    # Waits for given `event` to fire. If predicate is provided, it passes event's value into the `predicate` function and
+    # waits for `predicate(event)` to return a truthy value. Will throw an error if the socket is closed before the `event` is
+    # fired.
+    def wait_for_event(event, predicate: nil, timeout: nil)
+      raise NotImplementedError.new('wait_for_event is not implemented yet.')
     end
 
     # @nodoc
-    def after_initialize
-      wrap_impl(@impl.after_initialize)
+    def options=(req)
+      wrap_impl(@impl.options=(unwrap_impl(req)))
     end
 
     # @nodoc
@@ -556,13 +740,13 @@ module Playwright
     end
 
     # @nodoc
-    def owner_page=(req)
-      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
+    def pause
+      wrap_impl(@impl.pause)
     end
 
     # @nodoc
-    def options=(req)
-      wrap_impl(@impl.options=(unwrap_impl(req)))
+    def owner_page=(req)
+      wrap_impl(@impl.owner_page=(unwrap_impl(req)))
     end
 
     # -- inherited from EventEmitter --

data/lib/playwright_api/browser_type.rb

@@ -15,6 +15,23 @@ module Playwright
   # })();
   # ```
   # 
+  # ```java
+  # import com.microsoft.playwright.*;
+  # 
+  # public class Example {
+  #   public static void main(String[] args) {
+  #     try (Playwright playwright = Playwright.create()) {
+  #       BrowserType chromium = playwright.chromium();
+  #       Browser browser = chromium.launch();
+  #       Page page = browser.newPage();
+  #       page.navigate("https://example.com");
+  #       // other actions...
+  #       browser.close();
+  #     }
+  #   }
+  # }
+  # ```
+  # 
   # ```python async
   # import asyncio
   # from playwright.async_api import async_playwright
@@ -49,11 +66,6 @@ module Playwright
   # ```
   class BrowserType < PlaywrightApi
 
-    # This methods attaches Playwright to an existing browser instance.
-    def connect(params)
-      raise NotImplementedError.new('connect is not implemented yet.')
-    end
-
     # A path where Playwright expects to find a bundled browser executable.
     def executable_path
       wrap_impl(@impl.executable_path)
@@ -70,6 +82,12 @@ module Playwright
     # });
     # ```
     # 
+    # ```java
+    # // Or "firefox" or "webkit".
+    # Browser browser = chromium.launch(new BrowserType.LaunchOptions()
+    #   .setIgnoreDefaultArgs(Arrays.asList("--mute-audio")));
+    # ```
+    # 
     # ```python async
     # browser = await playwright.chromium.launch( # or "firefox" or "webkit".
     #     ignore_default_args=["--mute-audio"]
@@ -82,22 +100,23 @@ module Playwright
     # )
     # ```
     # 
-    # > **Chromium-only** Playwright can also be used to control the Chrome browser, but it works best with the version of
-    # Chromium it is bundled with. There is no guarantee it will work with any other version. Use `executablePath` option with
-    # extreme caution.
+    # > **Chromium-only** Playwright can also be used to control the Google Chrome or Microsoft Edge browsers, but it works
+    # best with the version of Chromium it is bundled with. There is no guarantee it will work with any other version. Use
+    # `executablePath` option with extreme caution.
     # >
     # > If Google Chrome (rather than Chromium) is preferred, a
     # [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or
     # [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested.
     # >
-    # > In [`method: BrowserType.launch`] above, any mention of Chromium also applies to Chrome.
-    # >
-    # > See [`this article`](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for
-    # a description of the differences between Chromium and Chrome.
-    # [`This article`](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md)
+    # > Stock browsers like Google Chrome and Microsoft Edge are suitable for tests that require proprietary media codecs for
+    # video playback. See
+    # [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for other
+    # differences between Chromium and Chrome.
+    # [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md)
     # describes some differences for Linux users.
     def launch(
           args: nil,
+          channel: nil,
           chromiumSandbox: nil,
           devtools: nil,
           downloadsPath: nil,
@@ -108,14 +127,12 @@ module Playwright
           handleSIGINT: nil,
           handleSIGTERM: nil,
           headless: nil,
-          ignoreAllDefaultArgs: nil,
           ignoreDefaultArgs: nil,
-          logger: nil,
           proxy: nil,
           slowMo: nil,
           timeout: nil,
           &block)
-      wrap_impl(@impl.launch(args: unwrap_impl(args), chromiumSandbox: unwrap_impl(chromiumSandbox), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), headless: unwrap_impl(headless), ignoreAllDefaultArgs: unwrap_impl(ignoreAllDefaultArgs), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), logger: unwrap_impl(logger), proxy: unwrap_impl(proxy), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
+      wrap_impl(@impl.launch(args: unwrap_impl(args), channel: unwrap_impl(channel), chromiumSandbox: unwrap_impl(chromiumSandbox), devtools: unwrap_impl(devtools), downloadsPath: unwrap_impl(downloadsPath), env: unwrap_impl(env), executablePath: unwrap_impl(executablePath), firefoxUserPrefs: unwrap_impl(firefoxUserPrefs), handleSIGHUP: unwrap_impl(handleSIGHUP), handleSIGINT: unwrap_impl(handleSIGINT), handleSIGTERM: unwrap_impl(handleSIGTERM), headless: unwrap_impl(headless), ignoreDefaultArgs: unwrap_impl(ignoreDefaultArgs), proxy: unwrap_impl(proxy), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
     end
 
     # Returns the persistent browser context instance.
@@ -127,6 +144,7 @@ module Playwright
           acceptDownloads: nil,
           args: nil,
           bypassCSP: nil,
+          channel: nil,
           chromiumSandbox: nil,
           colorScheme: nil,
           deviceScaleFactor: nil,
@@ -142,69 +160,38 @@ module Playwright
           hasTouch: nil,
           headless: nil,
           httpCredentials: nil,
-          ignoreAllDefaultArgs: nil,
           ignoreDefaultArgs: nil,
           ignoreHTTPSErrors: nil,
           isMobile: nil,
           javaScriptEnabled: nil,
           locale: nil,
-          logger: nil,
+          noViewport: nil,
           offline: nil,
           permissions: nil,
           proxy: nil,
-          recordHar: nil,
-          recordVideo: nil,
+          record_har_omit_content: nil,
+          record_har_path: nil,
+          record_video_dir: nil,
+          record_video_size: nil,
+          screen: nil,
           slowMo: nil,
           timeout: nil,
           timezoneId: nil,
           userAgent: nil,
-          videoSize: nil,
-          videosPath: nil,
           viewport: nil)
       raise NotImplementedError.new('launch_persistent_context is not implemented yet.')
     end
 
-    # Returns the browser app instance.
-    # 
-    # Launches browser server that client can connect to. An example of launching a browser executable and connecting to it
-    # later:
-    # 
-    #
-    # ```js
-    # const { chromium } = require('playwright');  // Or 'webkit' or 'firefox'.
-    # 
-    # (async () => {
-    #   const browserServer = await chromium.launchServer();
-    #   const wsEndpoint = browserServer.wsEndpoint();
-    #   // Use web socket endpoint later to establish a connection.
-    #   const browser = await chromium.connect({ wsEndpoint });
-    #   // Close browser instance.
-    #   await browserServer.close();
-    # })();
-    # ```
-    def launch_server(
-          args: nil,
-          chromiumSandbox: nil,
-          devtools: nil,
-          downloadsPath: nil,
-          executablePath: nil,
-          firefoxUserPrefs: nil,
-          handleSIGHUP: nil,
-          handleSIGINT: nil,
-          handleSIGTERM: nil,
-          headless: nil,
-          logger: nil,
-          port: nil,
-          proxy: nil,
-          timeout: nil)
-      raise NotImplementedError.new('launch_server is not implemented yet.')
-    end
-
     # Returns browser name. For example: `'chromium'`, `'webkit'` or `'firefox'`.
     def name
       wrap_impl(@impl.name)
     end
 
+    # @nodoc
+    def connect_over_cdp(endpointURL, slowMo: nil, timeout: nil, &block)
+      wrap_impl(@impl.connect_over_cdp(unwrap_impl(endpointURL), slowMo: unwrap_impl(slowMo), timeout: unwrap_impl(timeout), &wrap_block_call(block)))
+    end
+
     # -- inherited from EventEmitter --
     # @nodoc
     def once(event, callback)