0.18.0 (2026-03-28)
⚠ BREAKING CHANGES
tools plugin group
Plugins that use external tools (adblocker, camoufox, fingerprint, weston, xvfb) have been moved to the tools group. This new group is not exported along with the other plugins; you must import the desired plugin individually.
-
Before
<=0.17.0: (example forxvfb)import { chromium } from "playwright-ghost"; import plugins from "playwright-ghost/plugins"; const browser = await chromium.launch({ plugins: [ ...plugins.recommended(), plugins.utils.xvfb(), ], }); // ...
-
After
>=0.18.0:import { chromium } from "playwright-ghost"; import plugins from "playwright-ghost/plugins"; import toolsXvfbPlugin from "playwright-ghost/plugins/tools/xvfb"; const browser = await chromium.launch({ plugins: [ ...plugins.recommended(), toolsXvfbPlugin(), ], }); // ...
tools plugin with npm dependencies
The npm dependencies for the tools plugins (adblocker, camoufox, fingerprint) are no longer included in Playwright-ghost. You must add them to your dependencies.
-
Before
<=0.17.0: (example forcamoufox){ "dependencies": { "playwright": "1.58.2", "playwright-ghost": "0.17.0" } } -
After
>=0.18.0:{ "dependencies": { "camoufox-js": "0.9.3", "playwright": "1.58.2", "playwright-ghost": "0.18.0" } }
playwright (and alternatives)
The minimum version of playwright (and patchright) is 1.58.0. rebrowser-playwright is no longer supported (the project appears to have been abandoned).