Playwright Installation Guide for Beginners (Windows, Mac & Linux) — 2026

Modern web apps are fast, dynamic and JavaScript-heavy — traditional automation tools often struggle with flaky tests, sync issues and slow execution. Playwright solves all three. In this complete Playwright installation guide you'll go from a blank machine to a running test in under 15 minutes — on Windows, Mac or Linux.

By the end you'll know what Playwright is, why QA engineers prefer it, how to install and configure it, how to run your first test, and how to fix the most common installation errors. If you want the deeper API tour after setup, read our Playwright complete guide.

Playwright is an open-source automation framework from Microsoft for web UI, end-to-end, cross-browser, API and mobile-browser testing. It drives Chromium, Firefox and WebKit from a single API, which means you can test Chrome, Edge, Firefox and Safari-like browsers with the same code. After install, jump into our Playwright complete guide for locators, fixtures and the Page Object Model.

• Auto-waiting for elements, navigation and network — far fewer flaky tests.
• Cross-browser Chromium, Firefox and WebKit out of the box.
• Fast execution with parallel workers and headless mode.
• Built-in API testing (GET/POST/PUT/DELETE) — no extra libraries.
• World-class debugging: Trace Viewer, screenshots, video, HTML reports.

You need Node.js, npm, a working internet connection, and ideally VS Code.

Download the LTS version from the official Node.js website.

• Windows: run the .msi installer, accept defaults, finish.
• Mac: run the .pkg installer (or brew install node).
• Linux (Ubuntu/Debian): sudo apt update && sudo apt install nodejs npm.

Verify the install:

node -v   # e.g. v22.0.0
npm -v    # e.g. 10.5.1

Create a project folder and initialise Playwright:

mkdir playwright-project
cd playwright-project
npm init -y
npm init playwright@latest

The interactive CLI asks a few questions — recommended answers:

• TypeScript (better autocomplete & maintainability)
• Install browsers: Yes (downloads Chromium, Firefox, WebKit)
• GitHub Actions workflow: Yes (useful for CI/CD later)

If browsers don't install automatically, run:

npx playwright install

playwright-project/
├── tests/                  # your test scripts (*.spec.ts)
├── playwright.config.ts    # main config
├── package.json
├── node_modules/
└── playwright-report/      # generated after a run

Execute the bundled sample suite:

npx playwright test

You should see something like 3 passed. Open the HTML report with:

npx playwright show-report

Now create your own test at tests/login.spec.ts:

import { test, expect } from '@playwright/test';

test('Verify page title', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page).toHaveTitle(/Example/);
});

Run just this file: npx playwright test login.spec.ts.

npx playwright test --project=chromium
npx playwright test --project=firefox
npx playwright test --project=webkit

# headed (see the browser)
npx playwright test --headed

# step-by-step debugger
npx playwright test --debug

Default is headless mode — fastest for CI. Use --debug for the Playwright Inspector with pause and locator inspection.

Edit playwright.config.ts:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  testDir: './tests',
  timeout: 30000,
  retries: 1,
  use: {
    headless: true,
    screenshot: 'only-on-failure',
    video: 'retain-on-failure',
  },
});

Install Visual Studio Code and the Playwright Test for VSCode extension — you'll get one-click run, visual debug, locator recording and code generation inside the editor.

Auto-generate test code by interacting with a real site:

npx playwright codegen https://example.com

Playwright records your clicks and types and emits a clean spec file — perfect for beginners.

• node is not recognized — restart your terminal after installing Node.js, or reinstall and ensure Node.js is on your PATH.
• Browser download failed — re-run npx playwright install.
• Linux permission errors — sudo chmod -R 777 playwright-project.
• npm install failed — npm cache clean --force then reinstall.
• Dependency issues — delete node_modules and package-lock.json, then npm install.

1. Use TypeScript for autocomplete and maintainability.
2. Keep tests independent — each test should set up and tear down its own state.
3. Use the Page Object Model for reusable, scalable test code.
4. Avoid hard waits like waitForTimeout(5000). Rely on auto-waiting and web-first assertions.
5. Store test data & credentials separately — outside spec files, in env vars or fixtures.

Your environment is ready — now go deeper:

• Playwright complete guide — locators, fixtures, POM, API testing, visual testing, auth and CI/CD.
• 45+ Playwright interview questions for SDET interviews.
• API testing interview questions.
• AI mock interview — practise Playwright rounds live.

Playwright is fast, reliable and beginner-friendly — and now you have it installed and running. Keep practising daily, build a small real-world automation project, and your QA career will accelerate fast in 2026.