Patchright Python

To achieve the highest level of undetectability, it is recommended to use Google Chrome instead of Chromium and avoid manual fingerprint injection.

1. Install Chrome via: patchright install chrome.
2. Use launch_persistent_context with channel="chrome".
3. Crucial: Do NOT add custom browser headers or a custom user_agent, as these can be detected.

Recommended configuration:

playwright.chromium.launch_persistent_context(
    user_data_dir="...",
    channel="chrome",
    headless=False,
    no_viewport=True,
    # do NOT add custom browser headers or user_agent
    ...
)

Patchright is designed to be a drop-in replacement for Playwright. You can use either the synchronous or asynchronous API by importing from patchright.sync_api or patchright.async_api respectively.

# Synchronous usage
from patchright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto('http://playwright.dev')
    page.screenshot(path=f'example-{p.chromium.name}.png')
    browser.close()

Install the patchright package from PyPI using pip, then install the necessary Chromium driver.

Note: Patchright only supports Chromium-based browsers. Firefox and Webkit are not supported.

# Install Patchright with Pip from PyPI
pip install patchright

# Install Chromium-Driver for Patchright
patchright install chromium

For asynchronous workflows, import from patchright.async_api and use async with context managers.

import asyncio
# patchright here!
from patchright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        await page.goto('http://playwright.dev')
        await page.screenshot(path=f'example-{p.chromium.name}.png')
        await browser.close()

asyncio.run(main())

Patchright extends the Locator.evaluate_all method by adding an isolated_context parameter. This allows you to choose the Execution Context (Main or Isolated) for the JavaScript expression execution. By default, isolated_context is set to True (Isolated context).

# Example of the extended signature for Locator.evaluate_all
Locator.evaluate_all(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
    isolated_context: typing.Optional[bool] = True
)

Patchright extends the standard Playwright evaluate family of methods by adding an isolated_context parameter. This allows you to choose the Execution Context (Main or Isolated) for the JavaScript expression execution. By default, isolated_context is set to True (Isolated context).

# Example of the extended signature for evaluate methods
# Supported on: Frame, Page, Locator, Worker, and JSHandle
object.evaluate(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
    isolated_context: typing.Optional[bool] = True
)

Patchright extends the standard Playwright evaluate_handle family of methods by adding an isolated_context parameter. This allows you to choose the Execution Context (Main or Isolated) for the JavaScript expression execution. By default, isolated_context is set to True (Isolated context).

# Example of the extended signature for evaluate_handle methods
# Supported on: Frame, Page, Locator, Worker, and JSHandle
object.evaluate_handle(
    expression: str,
    arg: typing.Optional[typing.Any] = None,
    ...,
    isolated_context: typing.Optional[bool] = True
)