tf-playwright-stealth

Warnings

• gotcha There are two similarly named, but distinct, Python packages: `tf-playwright-stealth` (this library) and `playwright-stealth`. They have different APIs. `tf-playwright-stealth` provides `stealth_sync` and `stealth_async` functions, while `playwright-stealth` offers a `Stealth` class. Attempting to import `Stealth` from `playwright_stealth` when `tf-playwright-stealth` is installed will result in an `ImportError`. Ensure you use the correct imports for the installed package.
  Fix: Use `from playwright_stealth import stealth_sync` or `from playwright_stealth import stealth_async` instead of `from playwright_stealth import Stealth` when using `tf-playwright-stealth`.
• gotcha Stealth plugins like `tf-playwright-stealth` primarily address browser fingerprinting (e.g., `navigator.webdriver`, plugins, user-agent consistency). They do not inherently prevent detection based on IP reputation, TLS fingerprinting (JA3/JA4), behavioral analysis, or advanced JavaScript challenges employed by sophisticated anti-bot systems (like Cloudflare Turnstile, DataDome, Kasada).
  Fix: For more robust evasion against advanced detection, consider combining stealth techniques with residential proxies, careful pacing, human-like interaction simulation, and potentially specialized managed browser infrastructure or CAPTCHA-solving services.
• gotcha Older versions (prior to 1.x, or specific bugfix releases) of `playwright_stealth` (the internal module name) may have suffered from a missing `__init__.py` file, leading to `ImportError` issues. While likely resolved in current versions, users experiencing import problems should verify the package structure or update to the latest release.
  Fix: Upgrade to the latest version of `tf-playwright-stealth` (`pip install --upgrade tf-playwright-stealth`) and ensure a clean Python environment.

Install

• pip install tf-playwright-stealth Install stable version

Imports

• stealth_sync

  from playwright_stealth import stealth_sync

• stealth_async

  from playwright_stealth import stealth_async

• Stealth
  The 'Stealth' class (with a capital 'S') belongs to the separate 'playwright-stealth' package, not 'tf-playwright-stealth'. This package exports 'stealth_sync' and 'stealth_async' (lowercase 's') functions.

Quickstart

This quickstart demonstrates how to apply stealth features to a synchronous Playwright page. It launches a headless Chromium browser, applies the `stealth_sync` function to the page, and then navigates to a bot detection test site (sannysoft.com) to verify its effectiveness.

from playwright.sync_api import sync_playwright
from playwright_stealth import stealth_sync

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True)
    page = browser.new_page()
    stealth_sync(page)
    page.goto("https://bot.sannysoft.com/")
    print(f"Page title: {page.title()}")
    page.screenshot(path="example_with_stealth.png", full_page=True)
    browser.close()