freedak/invisible_playwright
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Federico
2026-06-06 07:51:46 +02:00
committed by GitHub
parent b7eda606a2
commit 262d388b99
1 changed files with 0 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
-21
View File
@@ -186,27 +186,6 @@ invisible_playwright version # wrapper and binary versions
invisible_playwright clear-cache # remove all cached binaries invisible_playwright clear-cache # remove all cached binaries
``` ```
## Public API for downstream integrations
When you're building a third-party fetcher (a Crawlee `BrowserPool` subclass, a changedetection.io plugin, an agno toolkit, a Skyvern backend) and need to own the browser lifecycle yourself, use the public helpers instead of `InvisiblePlaywright`:
```python
from playwright.async_api import async_playwright
from invisible_playwright import ensure_binary, get_default_stealth_prefs
async with async_playwright() as p:
browser = await p.firefox.launch(
executable_path=str(ensure_binary()),
firefox_user_prefs=get_default_stealth_prefs(seed=42),
)
```
`get_default_stealth_prefs(seed, *, pin, locale, timezone, extra_prefs, humanize, virtual_display)` returns the same dict that `InvisiblePlaywright(seed=..., locale=..., ...)` would inject. Same deterministic seed semantics, same humanize toggle, same `extra_prefs` overlay. `ensure_binary()` downloads the patched Firefox on first call and returns its absolute path.
> Important: pass `headless=False` to `firefox.launch()` and manage display hiding yourself (Xvfb on Linux, hidden desktop on Windows). Passing `headless=True` directly puts Firefox in true headless mode and skips the real rendering pipeline, which breaks canvas / audio / WebGL fingerprint coherence. The `InvisiblePlaywright` context manager does this translation automatically; the public helpers leave it to the caller.
For everyday Python usage the `InvisiblePlaywright` context manager is still the recommended entry point.
## Related projects ## Related projects
invisible_playwright takes a different angle than the major Firefox-hardening projects but stands on their shoulders: invisible_playwright takes a different angle than the major Firefox-hardening projects but stands on their shoulders: