npmpackage.info

Gathering detailed insights and metrics for playwright-extra

Other packages similar to playwright-extra

@devoxa/playwright-extra

2.2.0

Extra utility functions for interacting with Playwright

playwright-extra-plugin-stealth

0.0.1

This is a placeholder package for the upcoming playwright-extra stealth plugin.

playwright-extra-stealth

0.0.1

This is a placeholder package for the upcoming playwright-extra stealth plugin.

@extra/proxy-router

3.1.6

A plugin for playwright & puppeteer to route proxies dynamically.

Gathering detailed insights and metrics for playwright-extra

playwright-extra - 4.3.6 | npmpackage.info

playwright-extra

💯 Teach puppeteer new tricks through plugins.

4.3.6

6,940

MIT

JavaScript

310.59 kB

Installations

npm install playwright-extra

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=12

Node Version

18.12.1

NPM Version

lerna/3.22.1/node@v18.12.1+arm64 (darwin)

Pull Requests

Open

33

Total

222

Closed

63

Merged

126

Issues

Open

233

Total

678

Closed

445

Releases

Unable to fetch releases

Languages

JavaScript

TypeScript

HTML

Shell

JavaScript (59.86%)

TypeScript (39.86%)

HTML (0.19%)

Shell (0.09%)

Developer

berstend

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

6,940 Stars

604 Commits

758 Forks

115 Watchers

5 Branches

49 Contributors

Updated on Jul 16, 2025

Maintainers

View All 49 Contributors

Package Meta Information

Latest Version

4.3.6

Package Id

playwright-extra@4.3.6

Unpacked Size

310.59 kB

Size

66.59 kB

File Count

NPM Version

lerna/3.22.1/node@v18.12.1+arm64 (darwin)

Node Version

18.12.1

Published on

Mar 01, 2023

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

playwright-extra

A modular plugin framework for playwright to enable cool plugins through a clean interface.

Installation

1yarn add playwright playwright-extra
2# - or -
3npm install playwright playwright-extra

Changelog

Please check the announcements channel in our discord server until we've automated readme updates. :)

v4.3
- Rerelease due to versioning issues with previous beta packages
v3.3
- Initial public release

Quickstart

1// playwright-extra is a drop-in replacement for playwright,
2// it augments the installed playwright with plugin functionality
3const { chromium } = require('playwright-extra')
4
5// Load the stealth plugin and use defaults (all tricks to hide playwright usage)
6// Note: playwright-extra is compatible with most puppeteer-extra plugins
7const stealth = require('puppeteer-extra-plugin-stealth')()
8
9// Add the plugin to playwright (any number of plugins can be added)
10chromium.use(stealth)
11
12// That's it, the rest is playwright usage as normal 😊
13chromium.launch({ headless: true }).then(async browser => {
14  const page = await browser.newPage()
15
16  console.log('Testing the stealth plugin..')
17  await page.goto('https://bot.sannysoft.com', { waitUntil: 'networkidle' })
18  await page.screenshot({ path: 'stealth.png', fullPage: true })
19
20  console.log('All done, check the screenshot. ✨')
21  await browser.close()
22})

The above example uses the compatible stealth plugin from puppeteer-extra, that plugin needs to be installed as well:

1yarn add puppeteer-extra-plugin-stealth
2# - or -
3npm install puppeteer-extra-plugin-stealth

If you'd like to see debug output just run your script like so:

1# macOS/Linux (Bash)
2DEBUG=playwright-extra*,puppeteer-extra* node myscript.js
3
4# Windows (Powershell)
5$env:DEBUG='playwright-extra*,puppeteer-extra*';node myscript.js

More examples

TypeScript & ESM usage

playwright-extra and most plugins are written in TS, so you get perfect type support out of the box. :)

1// playwright-extra is a drop-in replacement for playwright,
2// it augments the installed playwright with plugin functionality
3import { chromium } from 'playwright-extra'
4
5// Load the stealth plugin and use defaults (all tricks to hide playwright usage)
6// Note: playwright-extra is compatible with most puppeteer-extra plugins
7import StealthPlugin from 'puppeteer-extra-plugin-stealth'
8
9// Add the plugin to playwright (any number of plugins can be added)
10chromium.use(StealthPlugin())
11
12// ...(the rest of the quickstart code example is the same)
13chromium.launch({ headless: true }).then(async browser => {
14  const page = await browser.newPage()
15
16  console.log('Testing the stealth plugin..')
17  await page.goto('https://bot.sannysoft.com', { waitUntil: 'networkidle' })
18  await page.screenshot({ path: 'stealth.png', fullPage: true })
19
20  console.log('All done, check the screenshot. ✨')
21  await browser.close()
22})

New to Typescript? Here it is in 30 seconds or less 😄:

1# Optional: If you don't have yarn yet
2npm i --global yarn
3
4# Optional: Create new package.json if it's a new project
5yarn init -y
6
7# Add basic typescript dependencies
8yarn add --dev typescript @types/node esbuild esbuild-register
9
10# Bootstrap a tsconfig.json
11yarn tsc --init --target ES2020 --lib ES2020 --module commonjs --rootDir src --outDir dist
12
13# Add dependencies used in the quick start example
14yarn add playwright playwright-extra puppeteer-extra-plugin-stealth
15
16# Create source folder for the .ts files
17mkdir src
18
19# Now place the example code above in `src/index.ts`
20
21# Run the typescript code without the need of compiling it first
22node -r esbuild-register src/index.ts
23
24# You can now add Typescript to your CV 🎉

Using different browsers

1// Any browser supported by playwright can be used with plugins
2import { chromium, firefox, webkit } from 'playwright-extra'
3
4chromium.use(plugin)
5firefox.use(plugin)
6webkit.use(plugin)

Multiple instances with different plugins

Node.js imports are cached, therefore the default chromium, firefox, webkit export from playwright-extra will always return the same playwright instance.

1// Use `addExtra` to create a fresh and independent instance
2import playwright from 'playwright'
3import { addExtra } from 'playwright-extra'
4
5const chromium1 = addExtra(playwright.chromium)
6const chromium2 = addExtra(playwright.chromium)
7
8chromium1.use(onePlugin)
9chromium2.use(anotherPlugin)
10// chromium1 and chromium2 are independent

Plugins

We're currently in the process of making the existing puppeteer-extra plugins compatible with playwright-extra, the following plugins have been successfully tested already:

🔥 `puppeteer-extra-plugin-stealth`

Applies various evasion techniques to make detection of an automated browser harder
Compatible with Puppeteer & Playwright and chromium based browsers

Example: Using stealth in Playwright with custom options

1// The stealth plugin is optimized for chromium based browsers currently
2import { chromium } from 'playwright-extra'
3
4import StealthPlugin from 'puppeteer-extra-plugin-stealth'
5chromium.use(StealthPlugin())
6
7// New way to overwrite the default options of stealth evasion plugins
8// https://github.com/berstend/puppeteer-extra/tree/master/packages/puppeteer-extra-plugin-stealth/evasions
9chromium.plugins.setDependencyDefaults('stealth/evasions/webgl.vendor', {
10  vendor: 'Bob',
11  renderer: 'Alice'
12})
13
14// That's it, the rest is playwright usage as normal 😊
15chromium.launch({ headless: true }).then(async browser => {
16  const page = await browser.newPage()
17
18  console.log('Testing the webgl spoofing feature of the stealth plugin..')
19  await page.goto('https://webglreport.com', { waitUntil: 'networkidle' })
20  await page.screenshot({ path: 'webgl.png', fullPage: true })
21
22  console.log('All done, check the screenshot. ✨')
23  await browser.close()
24})

🏴 `puppeteer-extra-plugin-recaptcha`

Solves reCAPTCHAs and hCaptchas automatically, using a single line of code: page.solveRecaptchas()
Compatible with Puppeteer & Playwright and all browsers (chromium, firefox, webkit)

Example: Solving captchas in Playwright & Firefox

1// Any browser (chromium, webkit, firefox) can be used
2import { firefox } from 'playwright-extra'
3
4import RecaptchaPlugin from 'puppeteer-extra-plugin-recaptcha'
5firefox.use(
6  RecaptchaPlugin({
7    provider: {
8      id: '2captcha',
9      token: process.env.TWOCAPTCHA_TOKEN || 'YOUR_API_KEY'
10    }
11  })
12)
13
14// Works in headless as well, just so you can see it in action
15firefox.launch({ headless: false }).then(async browser => {
16  const context = await browser.newContext()
17  const page = await context.newPage()
18  const url = 'https://www.google.com/recaptcha/api2/demo'
19  await page.goto(url, { waitUntil: 'networkidle' })
20
21  console.log('Solving captchas..')
22  await page.solveRecaptchas()
23
24  await Promise.all([
25    page.waitForNavigation({ waitUntil: 'networkidle' }),
26    page.click(`#recaptcha-demo-submit`)
27  ])
28
29  const content = await page.content()
30  const isSuccess = content.includes('Verification Success')
31  console.log('Done', { isSuccess })
32  await browser.close()
33})

🆕 `plugin-proxy-router`

Use multiple proxies dynamically with flexible per-host routing and more
Compatible with Puppeteer & Playwright and all browsers (chromium, firefox, webkit)

Notes

If you're in need of adblocking use this package or block resources natively
We're focussing on compatiblity with existing plugins at the moment, more documentation on how to write your own playwright-extra plugins will follow

Contributors

License

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: third-party GitHubAction not pinned by hash: .github/workflows/extract-stealth.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/extract-stealth.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/extract-stealth.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/extract-stealth.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/extract-stealth.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/extract-stealth.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/label.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/label.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/test.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:58: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:66: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:84: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/test.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:90: update your workflow using https://app.stepsecurity.io/secureworkflow/berstend/puppeteer-extra/test.yml/master?enable=pin
Info: 0 out of 4 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 5 third-party GitHubAction dependencies pinned

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

63 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q
Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38
Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc
Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx
Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-wg6g-ppvx-927h
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99
Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q
Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
Warn: Project is vulnerable to: GHSA-7wwv-vh3v-89cq
Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22
Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g
Warn: Project is vulnerable to: GHSA-3j8f-xvm3-ffx4
Warn: Project is vulnerable to: GHSA-4p35-cfcx-8653
Warn: Project is vulnerable to: GHSA-7f3x-x4pr-wqhj
Warn: Project is vulnerable to: GHSA-jpp7-7chh-cf67
Warn: Project is vulnerable to: GHSA-q6wq-5p59-983w
Warn: Project is vulnerable to: GHSA-j9fq-vwqv-2fm2
Warn: Project is vulnerable to: GHSA-pqw5-jmp5-px4v
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-9q5w-79cv-947m
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-g4rg-993r-mgx7
Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
Warn: Project is vulnerable to: GHSA-pq67-2wwv-3xjx
Warn: Project is vulnerable to: GHSA-8cj5-5rvv-wf4v
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq
Warn: Project is vulnerable to: GHSA-7p7h-4mm5-852v
Warn: Project is vulnerable to: GHSA-38fc-wpqx-33j7
Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3
Warn: Project is vulnerable to: GHSA-rqff-837h-mm52
Warn: Project is vulnerable to: GHSA-8v38-pw62-9cw2
Warn: Project is vulnerable to: GHSA-hgjh-723h-mx2j
Warn: Project is vulnerable to: GHSA-jf5r-8hm2-f872
Warn: Project is vulnerable to: GHSA-g3ch-rx76-35fx
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

3

/10

Last Scanned on 2025-07-14

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to playwright-extra

Other packages similar to playwright-extra

playwright-extra

Installations

Developer Guide

No

CommonJS

>=12

18.12.1

lerna/3.22.1/node@v18.12.1+arm64 (darwin)

Pull Requests

33

222

63

126

Issues

233

678

445

Releases

Unable to fetch releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

playwright-extra

Installation

Quickstart

More examples

Plugins

🔥 puppeteer-extra-plugin-stealth

🏴 puppeteer-extra-plugin-recaptcha

🆕 plugin-proxy-router

Contributors

License

10

10

10

2

0

0

0

0

0

0

0

0

3

/10

🔥 `puppeteer-extra-plugin-stealth`

🏴 `puppeteer-extra-plugin-recaptcha`

🆕 `plugin-proxy-router`