v0.18.0

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 for xvfb)

  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 for camoufox)

  {
    "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).

Features

• Improve dependencies of plugins. (3e089a1)
• Support Lightpanda. (4d92b2f)

Bug Fixes

• Don't create duplicate weston. (8cde4ad)
• Don't create duplicate Xvfb. (6ffb816)
• Improve types. (104fa14)
• Remove Rebrowser. (0acf22f)

v0.17.0

0.17.0 (2026-01-09)

Features

• Add support to BrowserType.connect and BrowserType.connectOverCDP. (480b31c)
• Add support to BrowserType.launchServer. (95810a1)
• Support "steps" in plugin humanize.cursor. (1d038fe)
• Support Bun. (8ab2cc9)

Bug Fixes

• Do not re-export types that no longer exist. (cff3293)
• plugin/adblocker: Wait blocking enable. (dcc4e2c)
• plugin/humanize/cursor: Fix negative delay. (cf23a2c)
• plugin/sniffer: Bypass CSP and optimize. (0f5766c)
• plugin/weston: Kill weston when persistent context is closed. (0f8496d)
• plugin/xvfb: Kill Xvfb when persistent context is closed. (8fa48d9)
• Support click in plugin debug.cursor. (37366ed)

v0.16.0

0.16.0 (2025-11-16)

Features

• Add plugin to run browser in weston (Wayland). (4d2abe6)
• Add plugin to sniff JavaScript properties used. (1c9f663)
• Move debug plugin in debug group. (8e94f85)

v0.15.0

0.15.0 (2025-10-05)

⚠ BREAKING CHANGES

• Remove deprecated plugin export from "playwright-ghost". Now plugins are only available from "playwright-ghost/plugins":

  import plugins from "playwright-ghost/plugins";

Bug Fixes

• plugin/userAgent: Change user agent with Firefox. (dfbfd5f)
• plugin/xvfb: Support Chromium 140 (with use Wayland). (4c8d50b)
• Remove deprecated plugins. (0d12cff)

v0.14.2

0.14.2 (2025-08-02)

Bug Fixes

• Fix plugin utils.xvfb. (9ec63c8)
• Re-export Playwright types. (3fa21f4)

v0.14.1

0.14.1 (2025-07-30)

Bug Fixes

• Use caret range for JSR. (51936a0)

v0.14.0

0.14.0 (2025-07-30)

⚠ BREAKING CHANGES

Plugin import has changed:

• before <=0.13.0:

  import { plugins } from "playwright-ghost";

• after >=0.14.0:

  import plugins from "playwright-ghost/plugins";

npm dependencies of plugins (utils.adblocker and utils.fingerprint) are now integrated into Playwright-ghost. You no longer need to add them (@ghostery/adblocker-playwright, fingerprint-generator or fingerprint-injector) to your dependencies.

You can now import just one plugin. For example, with utils.camoufox:

import { chromium } from "playwright-ghost";
import camoufoxPlugin from "playwright-ghost/plugins/utils/camoufox";

const browser = await chromium.launch({
  plugins: [camoufoxPlugin()],
});
// ...

Features

• Add a plugin for Camoufox. (1777fc3)
• Optimize plugins. (#20) (0f2ce8c)
• plugin/debug: Show cursor. (f008a8f)

Bug Fixes

• plugin/xvfb: Support Explicit Resource Management. (16a6259)

v0.13.0

0.13.0 (2025-04-27)

Features

• Can disable plugins recommended. (329b1b0)
• plugin/cursor: Starts at a random position. (f8b9c78)

Bug Fixes

• plugin/click: Hook Mouse functions. (fba09f9)

v0.12.0

0.12.0 (2025-03-28)

Features

• Add plugin to fingerprint. (0484e2f)
• plugin/cursor: Click in the element's ellipse. (284e7d7)
• Support hook on Frame. (3a5e13e)

v0.11.0

0.11.0 (2025-03-05)

Features

• Enable deactivation of recommended plugins. (8fb6f0d)

Bug Fixes

• plugin/cursor: Support click on inaccessible locator. (0e5fed7)