feat: add 'connectBrowserApp' option (#90)

Co-authored-by: jochen <[email protected]>

Author: headlesstesting

README.md

@@ -73,6 +73,7 @@ describe('Google', () => {
 You can specify a `jest-playwright.config.js` at the root of the project or define a custom path using `JEST_PLAYWRIGHT_CONFIG` environment variable. It should export a config object.
 
 - `launchBrowserApp` <[object]> [All Playwright launch options](https://github.com/microsoft/playwright/blob/master/docs/api.md#browsertypelaunchoptions) can be specified in config. Since it is JavaScript, you can use all stuff you need, including environment.
+- `connectBrowserApp` <[object]> [All Playwright connect options](https://github.com/microsoft/playwright/blob/master/docs/api.md#browsertypeconnectoptions) can be specified in config.
 - `context` <[object]> [All Playwright context options](https://github.com/microsoft/playwright/blob/master/docs/api.md#browsernewcontextoptions) can be specified in config.
 - `browser` <[string]>. Define a [browser](https://github.com/microsoft/playwright/blob/master/docs/api.md#class-browsertype) to run tests into.
   - `chromium` Each test runs Chromium (default).

src/PlaywrightEnvironment.ts

@@ -63,14 +63,19 @@ const getBrowserPerProcess = async (
   if (!browserPerProcess) {
     const browserType = getBrowserType(config)
     checkBrowserEnv(browserType)
-    const { launchBrowserApp } = config
+    const { launchBrowserApp, connectBrowserApp } = config
     // https://github.com/mmarkelov/jest-playwright/issues/42#issuecomment-589170220
     if (browserType !== CHROMIUM && launchBrowserApp && launchBrowserApp.args) {
       launchBrowserApp.args = launchBrowserApp.args.filter(
         (item) => item !== '--no-sandbox',
       )
     }
-    browserPerProcess = await playwrightInstance.launch(launchBrowserApp)
+
+    if (connectBrowserApp) {
+      browserPerProcess = await playwrightInstance.connect(connectBrowserApp)
+    } else {
+      browserPerProcess = await playwrightInstance.launch(launchBrowserApp)
+    }
   }
   return browserPerProcess
 }

src/constants.ts

@@ -5,6 +5,7 @@ import {
   ChromiumBrowser,
   FirefoxBrowser,
   BrowserType as PlaywrighBrowserType,
+  BrowserTypeConnectOptions,
 } from 'playwright-core'
 import { JestDevServerOptions } from 'jest-dev-server'
 
@@ -37,6 +38,7 @@ export interface Config {
   devices?: string[]
   server?: JestDevServerOptions
   selectors?: SelectorType[]
+  connectBrowserApp?: BrowserTypeConnectOptions
 }
 
 export const DEFAULT_CONFIG: Config = {