Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

For the standard Node.js setup, open PowerShell in your project directory, run npm init playwright@latest, then run npx playwright test. The initializer can create a starter test and configuration and install the browser binaries Playwright needs. This guide is for Playwright Test with Node.js; Python, .NET and Java use different commands.

Choose the Playwright setup that matches your language

Playwright is available through language-specific packages and workflows. The commands below are not interchangeable: use the path for the runtime and project you already work with.

Language Typical setup Use this path when
Node.js npm init playwright@latest You want the Playwright Test runner, its configuration and a starter test.
Python pip install playwright, then playwright install Your tests or automation are written in Python. The official guide lists Python 3.8 or higher.
.NET Create a .NET project, add the Playwright .NET package, then run the generated browser-install script. You use the .NET test integration. The official guide recommends .NET 8.
Java Follow the Maven-oriented Java guide. Your application or tests use Java and Maven.

The main walkthrough below uses Node.js and Playwright Test, the shortest route to a generated example test. For other bindings, start with the official Python guide, .NET guide or Java guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set up Playwright Test with Node.js

1. Check Windows and Node.js

Playwright’s documented Windows requirements list Windows 11 or later and Windows Server 2019 or later; WSL is also listed as a supported environment. Install Node.js before creating the project. Supported Node versions can change, so check the current stable Playwright installation guide rather than treating a version mentioned on a Next documentation page as a permanent requirement.

#1 Best Overall

2. Open PowerShell in your project directory

For a new project, create or choose a directory, then open PowerShell there. Run:

npm init playwright@latest

The same initializer can add Playwright to an existing project. It prompts you to choose JavaScript or TypeScript (TypeScript is the default), a test-folder name, whether to add an optional GitHub Actions workflow, and whether to install Playwright browser binaries. Browser installation is selected by default. The initializer can be rerun later and does not overwrite existing tests.

For a new project, accept the default choices unless your team has a reason to change them. The generated project includes package metadata, a Playwright configuration file (typically playwright.config.ts) and a starter test.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Run the starter test

In the same directory, run:

npx playwright test

By default, the generated configuration runs tests headlessly and in parallel across Chromium, Firefox and WebKit. The configuration can change which browser projects run. To see the browser window while a test runs, use:

npx playwright test --headed

To run only the Chromium project, use:

npx playwright test --project=chromium

To open Playwright UI Mode, use:

npx playwright test --ui

A passing run confirms that the test runner can find the generated test and launch the configured browsers. If the browser executable is missing, install the browser binaries as described below.

Install or update Playwright browser binaries

The Playwright package and its browser binaries are related but separate parts of the setup. As the official browser documentation puts it: “Each version of Playwright needs specific versions of browser binaries to operate.” Installing the package alone does not guarantee the required browser builds are present.

Rank #2
Dell Latitude 3190 11.6" HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
  • 1.1 GHz (boost up to 2.4GHz) Intel Celeron N5030 Quad-Core
  • 4GB DDR4 System Memory; 128GB Solid State Drive
  • 11.6" HD (1366 x 768) Multi-Touch Display
  • Combo headphone/microphone jack - Noble Wedge Lock slot - HDMI; 2 USB 3.1 Gen 1
  • Windows 11 Pro

If you skipped browser installation during initialization, or a test reports that a browser executable is missing, install the default browsers from PowerShell:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
npx playwright install

To install just Chromium instead:

npx playwright install chromium

After upgrading Playwright, run the browser-install command again if tests report a missing or incompatible browser. The installed browser builds are tied to the Playwright version in your project.

Where Playwright stores browser files

On Windows, the default browser cache is %USERPROFILE%AppDataLocalms-playwright. The browser guide estimates that installed browsers take a few hundred megabytes, so allow for that disk space and download time.

If you want the browser files somewhere else, set PLAYWRIGHT_BROWSERS_PATH in PowerShell before installing, and keep it set when running tests that use that cache:

$Env:PLAYWRIGHT_BROWSERS_PATH="$Env:USERPROFILEpw-browsers"
npx playwright install
npx playwright test

The environment variable is scoped to that PowerShell session. If you open a new window, set it again before running tests, or configure it persistently using your usual Windows environment-variable workflow.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use Python, .NET or Java instead

Python

For a Python project, install the Playwright package and then its browser binaries:

Rank #3
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
  • 256 GB SSD of storage.
  • Multitasking is easy with 16GB of RAM
  • Equipped with a blazing fast Core i5 2.00 GHz processor.
pip install playwright
playwright install

The official Python guide lists Python 3.8 or higher. Use the package manager and virtual-environment conventions of your project; these commands are not a substitute for the Node.js initializer.

.NET

The .NET route begins with a .NET project and the Playwright .NET package. After building the project, the guide uses a generated PowerShell script to install browsers. For a project targeting .NET 8, the example form is:

pwsh bin/Debug/net8.0/playwright.ps1 install

The script path depends on your project’s target framework and build output. If your project targets a different framework or configuration, use the matching generated path. The official guide recommends .NET 8.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Java

Java uses its own Maven-oriented setup. Follow the official Java guide for the dependency, project configuration and browser-install steps rather than running Node.js or Python commands in a Java project.

Troubleshoot common Windows setup problems

“Executable doesn’t exist” or a browser is missing

Cause: The package is installed but its matching browser binary is not, the browser download was skipped, or the package was upgraded and now expects a different build.

Fix: From the project directory, run npx playwright install. If your test uses one engine, install that engine explicitly, for example npx playwright install chromium. Confirm that you are running the command with the same project and Playwright installation as your test.

Rank #4
15.6 Inch Laptop Computer, N4020, 4GB DDR4 RAM, 128GB eMMC,with Windows 11
  • EFFORTLESS EVERYDAY PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 Home system, delivering reliable, low-power efficiency for daily tasks like document editing, email, online classes, and web browsing
  • 15.6-INCH FULL HD DISPLAY: Enjoy immersive visuals on the 15.6" FHD (1920x1080) anti-glare screen with micro-edge bezels. Delivers clear details and comfortable viewing for long study sessions, working on spreadsheets, and video playback
  • RESPONSIVE MULTITASKING & STORAGE: Built with 4GB LPDDR4 RAM and 128GB eMMC storage for smooth daily essential use. Expand your storage by up to 1TB via the integrated TF card slot to easily store movies, photos, and working files
  • ADVANCED CONNECTIVITY: Outfitted with 2x Full-Featured Type-C ports for data transfer, fast charging, and dual-monitor output, alongside 2x USB 3.2 Gen1 ports and a 3.5mm audio jack for complete peripheral compatibility
  • LIGHTWEIGHT & SILENT OPERATION: Slim and portable for effortless travel or commuting. Features a 1MP HD webcam for remote meetings, 38Wh battery with 45W Type-C fast charging, and a fanless silent design for peaceful work environments.

The browser download fails on a company or restricted network

Cause: A proxy or network policy may block access to the default browser download host.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Fix: If your network administrator provides a proxy, set the proxy for the PowerShell session before installation, then retry:

$Env:HTTPS_PROXY="http://proxy.example:8080"
npx playwright install

Replace the example address with the proxy address supplied for your network. Do not set proxy variables when they are not required.

The download reports a self-signed certificate chain

Cause: Some corporate proxies inspect HTTPS traffic and substitute certificates. Node.js may not trust the proxy’s certificate by default.

Fix: Ask your administrator for the trusted certificate file and set NODE_EXTRA_CA_CERTS in PowerShell before retrying the install:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
$Env:NODE_EXTRA_CA_CERTS="C:pathtotrusted-certificate.pem"
npx playwright install

Use the path to the certificate provided by your organization. This is a network-specific troubleshooting step, not a routine Playwright prerequisite.

Best Value
Sale
15.6 Inch Win 11 Laptop Computer, N4020, 4GB DDR4 RAM, 128GB Storage
  • WINDOWS 11 | STABLE PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 system, this laptop delivers stable performance for everyday computing tasks. It supports web browsing, online learning, document editing, email communication, and basic office work with optimized power efficiency, providing a practical and reliable experience for essential daily use for daily use.
  • 15.6” FHD IPS DISPLAY: Features a 15.6-inch Full HD IPS display with narrow bezels, offering wider viewing angles and clearer image details compared to standard panels. The improved screen-to-body ratio enhances visual experience for study, reading, document work, and video playback, making it suitable for both productivity and entertainment use.
  • 4GB DDR4 + 128GB eMMC STORAGE: Equipped with 4GB DDR4 memory and 128GB eMMC storage for everyday basics such as browsing, documents, email, and online learning platforms. The built-in TF card slot supports storage expansion up to 1TB, giving you more flexibility for files, photos, videos, and daily documents. TF card not included.
  • CONNECTIVITY & PORTS: Includes 1× TF card slot, 2× USB 3.2 Gen1 ports, and 2× full-featured Type-C ports (USB 3.2 Gen1). The Type-C ports support data transfer, charging, and video output, enabling flexible connection with external devices such as monitors, storage, and peripherals for daily work and study use.
  • LIGHTWEIGHT DESIGN | ONLINE COMMUNICATION: Designed with a slim, portable profile, this laptop is easy to carry for school, commuting, and travel. A built-in 1MP front camera supports online classes, video meetings, remote communication, and everyday conferencing. The 3300mAh battery works with the low-power system design to support practical daily use, while thermal optimization helps maintain quieter operation during extended tasks.

Tests pass in one PowerShell window but cannot find browsers in another

Cause: A custom PLAYWRIGHT_BROWSERS_PATH was set only in the original session.

Fix: Set the same variable before running tests in the new session, and make sure the browsers were installed at that path.

A test passes headlessly but you expected to see a window

Cause: Playwright Test runs headlessly by default.

Fix: Run npx playwright test --headed. To narrow the run to one configured browser, add --project=chromium if that project exists in your configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Practical performance and reliability notes

  • Keep the package and browser builds together: after changing the Playwright version, reinstall browsers if a missing executable or version mismatch appears.
  • Plan for browser storage: browser binaries take a few hundred megabytes according to the browser guide; a custom cache path can help when you need to manage disk location.
  • Expect network downloads during first setup: an existing package does not imply that its browser binaries have been downloaded.
  • Choose the test scope deliberately: the generated setup runs across three browser engines by default, but --project=chromium can help isolate a run while diagnosing a browser-specific issue.

Or skip the browser setup

If your goal is to capture a website rather than build browser automation tests, ScreenshotNeo is a website screenshot API and MCP server: one GET request with a URL can return a PNG, JPEG, WebP or PDF. Its API accepts clean-up options for consent banners, newsletter popups and chat widgets, with each step configurable. Bot checks, blank pages, timeouts, failed loads and cache hits are not billed, and the response identifies page verdict and billing status in headers. Its MCP server offers take_screenshot, get_page_info and capture_pdf for AI agents and MCP clients.

Example cURL request:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Replace YOUR_API_KEY with your key and change the target URL as needed. See the ScreenshotNeo API documentation for request options, response formats and other integrations. The Free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 screenshots. Sign up for the free plan.

Frequently Asked Questions

Does Playwright work on Windows 10?

The Windows requirements cited in this guide list Windows 11+ and Windows Server 2019+. Check the current official requirements before relying on an older Windows version.

Can I install only one Playwright browser?

Yes. For Chromium, run npx playwright install chromium from the Node.js project directory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Do I need Playwright Test to use Playwright?

No. Playwright has separate language packages and workflows, including Python, .NET and Java; choose the official guide for your runtime.

Quick Recap

Bestseller No. 1
HP 14' HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
HP 14" HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
14" diagonal, 1366x768 resolution, HD BrightView LED, Glossy NON-TOUCH Display
$247.99
Bestseller No. 2
Dell Latitude 3190 11.6' HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
Dell Latitude 3190 11.6" HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
1.1 GHz (boost up to 2.4GHz) Intel Celeron N5030 Quad-Core; 4GB DDR4 System Memory; 128GB Solid State Drive
Bestseller No. 3
Dell Latitude 5420 14' FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
256 GB SSD of storage.; Multitasking is easy with 16GB of RAM; Equipped with a blazing fast Core i5 2.00 GHz processor.
$289.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.