Playwright Guide

Playwright is one of the most popular automation libraries created by Microsoft, with over 65k stars on Github.

To begin, install Playwright

1
npm install playwright-core

Use chromium.connectOverCDP method to connect to your remote browser. Here's an example.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import { chromium } from 'playwright-core'

(async () => {
  const rebrowserParams = {
    apiKey: '<YOUR_API_KEY>',
  }
  const browser = await chromium.connectOverCDP(`wss://ws.rebrowser.net/?${new URLSearchParams(rebrowserParams)}`)
  const context = browser.contexts()[0]
  const page = await context.newPage()
  await page.goto('https://rebrowser.net')
  await page.close()

  await (await browser.newBrowserCDPSession()).send('Rebrowser.finishRun')
  await browser.close()
})().catch((error) => console.error(error.message))

Now you can visit Dashboard / Runs and see the results of your run.

Make sure to replace YOUR_API_KEY with your actual API key.

You can read more about all parameters to start a new run on Documentation / API / startRun.

If you have an existing codebase working with Playwright, it's super easy to modify it to start leveraging a remote browser instead.

Without Rebrowser

1
2
3
4
5
6
import playwright from 'playwright'

const browser = await playwright.chromium.launch()
const context = await browser.newContext()
const page = await context.newPage()
// ...

With Rebrowser

1
2
3
4
5
6
7
8
9
import { chromium } from 'playwright-core'

const rebrowserParams = {
  apiKey: 'YOUR_API_KEY',
}
const browser = await chromium.connectOverCDP(`wss://ws.rebrowser.net/?${new URLSearchParams(rebrowserParams)}`)
const context = browser.contexts()[0]
const page = await browser.newPage()
// ...

Python usage is quite similar to Node.js, we're gonna use connect_over_cdp. You just need to replace chromium.launch with chromium.connect_over_cdp in your existing code.

Take a look on the example below.

1
2
3
4
5
6
7
8
9
10
11
12
import asyncio
from rebrowser_playwright.async_api import async_playwright

async def main():
  async with async_playwright() as p:
    browser = await p.chromium.connect_over_cdp("wss://ws.rebrowser.net/?apiKey=YOUR_API_KEY")
    page = await browser.new_page()
    await page.goto("https://bot-detector.rebrowser.net/")
    # your business logic
    await browser.close()

asyncio.run(main())

All other programming language versions of Playwright support connectOverCDP. You just need to change one line of code to start using Rebrowser.

Get more info in Playwright docs: Java, .NET.

We highly encourage every customer to do some extra steps to fix all automation leaks.

You can read more on this page: Documentation / Stealth & Automation Detection

← Puppeteer
Other Libraries →