Playwright Stealth

https://pypi.org/project/playwright-stealth
Admin
Playwright Stealth is a library that makes Playwright instances evade bot detection methods by...
Tokens:1,953
Snippets:20
Trust Score:10
Update:6 days ago
Show doc for...
Tokens:
Raw
### Install playwright-stealth via pip

Source: https://pypi.org/project/playwright-stealth

Install the package from PyPI using pip. Run this command in your terminal.

```bash
$ pip install playwright-stealth

```

--------------------------------

### Advanced usage: custom config and manual evasion application

Source: https://pypi.org/project/playwright-stealth

Shows how to configure Stealth with custom navigator languages and init_scripts_only, then manually apply stealth to a context. Also demonstrates selective evasion usage with ALL_EVASIONS_DISABLED_KWARGS and enabling a single evasion.

```python
import asyncio
from playwright.async_api import async_playwright
from playwright_stealth import Stealth, ALL_EVASIONS_DISABLED_KWARGS


async def advanced_example():
    # Custom configuration with specific languages
    custom_languages = ("fr-FR", "fr")
    stealth = Stealth(
        navigator_languages_override=custom_languages,
        init_scripts_only=True
    )

    async with async_playwright() as p:
        browser = await p.chromium.launch()
        context = await browser.new_context()
        await stealth.apply_stealth_async(context)

        # Test stealth on multiple pages
        page_1 = await context.new_page()
        page_2 = await context.new_page()

        # Verify language settings
        for i, page in enumerate([page_1, page_2], 1):
            is_mocked = await page.evaluate("navigator.languages") == custom_languages
            print(f"Stealth applied to page {i}: {is_mocked}")

    # Example of selective evasion usage
    no_evasions = Stealth(**ALL_EVASIONS_DISABLED_KWARGS)
    single_evasion = Stealth(**{**ALL_EVASIONS_DISABLED_KWARGS, "navigator_webdriver": True})

    print("Total evasions (none):", len(no_evasions.script_payload))
    print("Total evasions (single):", len(single_evasion.script_payload))


asyncio.run(advanced_example())

```

--------------------------------

### Recommended usage: apply stealth to all pages with Stealth context manager

Source: https://pypi.org/project/playwright-stealth

Uses the Stealth context manager with async_playwright to automatically apply stealth to all pages created within the context. Evaluates navigator.webdriver on a page from new_page and a page from a new context to verify stealth.

```python
import asyncio
from playwright.async_api import async_playwright
from playwright_stealth import Stealth


async def main():
    # This is the recommended usage. All pages created will have stealth applied:
    async with Stealth().use_async(async_playwright()) as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()

        webdriver_status = await page.evaluate("navigator.webdriver")
        print("from new_page: ", webdriver_status)

        different_context = await browser.new_context()
        page_from_different_context = await different_context.new_page()

        different_context_status = await page_from_different_context.evaluate("navigator.webdriver")
        print("from new_context: ", different_context_status)


asyncio.run(main())

```
Tokens:
Raw