Playwright Installation

A carpenter cannot build furniture without a toolbox. A tester cannot write Playwright scripts without setting up the right tools first. This topic walks through every step needed to get a computer ready for Playwright testing, even for someone who has never installed a testing tool before.

What Gets Installed and Why

Playwright needs three things to work: Node.js to run JavaScript code, the Playwright package itself, and browser copies that Playwright controls during tests. The setup process installs all three in a few minutes.

Step 1: Installing Node.js

Node.js lets a computer run JavaScript outside a browser. Visit nodejs.org, download the recommended version, and install it like any other program. After installation, confirm it works by typing this command in a terminal:

node -v

A version number appearing on the screen confirms Node.js installed correctly.

Step 2: Creating a Project Folder

Every testing project lives inside its own folder. Create a new folder anywhere on the computer, then open a terminal inside that folder.

Step 3: Running the Playwright Setup Command

npm init playwright@latest

This single command does the heavy lifting. It asks a few simple questions, such as whether to use JavaScript or TypeScript, and where to place test files. Answering with the default options works well for beginners.

What Happens Behind the Scenes

Run Setup Command
      |
      v
Playwright Package Downloaded
      |
      v
Chrome, Firefox, WebKit Browsers Downloaded
      |
      v
Sample Test and Config File Created
      |
      v
Project Ready to Run

Step 4: Verifying the Installation

npx playwright test

This command runs the sample test Playwright created automatically. A short summary appears in the terminal showing tests passing in green text.

A Real Scenario

A new team member joins a company on Monday morning. By following these four steps, that person has a fully working test project running before lunch, without asking a single teammate for help.

Troubleshooting Tips

If a command shows "command not found," Node.js likely needs a computer restart after installation. If browser downloads fail, a firewall or slow internet connection is usually the cause, and running the command again often fixes it.

Quick Practice Task

Install Playwright on your own machine using the four steps above. Run the sample test and take note of how many tests pass by default.

Key Takeaways

• Node.js must exist before Playwright installation begins.
• One setup command installs Playwright and all required browsers.
• The sample test confirms a working installation immediately.
• A fresh project folder keeps testing files organized from day one.