Web Test Runner

Test runner for web applications.

👉   Headless browsers with Puppeteer, Playwright, or Selenium. 🚧   Reports logs, 404s, and errors from the browser. 🔍   Debug opens a real browser window with devtools. 📦   Mock es modules using Import Maps. 🔧   Exposes browser properties like viewport size and dark mode. ⏱  Runs tests in parallel and isolation. 👀   Interactive watch mode. 🏃   Fast development by rerunning only changed tests. 🚀   Powered by esbuild and rollup plugins

See our website for full documentation.

Installation

Install the web test runner:

npm i --save-dev @web/test-runner

Basic commands

Do a single test run:

web-test-runner test/**/*.test.js --node-resolve
wtr test/**/*.test.js --node-resolve

Run in watch mode, reloading on file changes:

web-test-runner test/**/*.test.js --node-resolve --watch
wtr test/**/*.test.js --node-resolve --watch

Run with code coverage profiling (this is slower):

web-test-runner test/**/*.test.js --node-resolve --coverage
wtr test/**/*.test.js --node-resolve --coverage

Transform JS to a compatible syntax based on user agent:

web-test-runner test/**/*.test.js --node-resolve --esbuild-target auto
wtr test/**/*.test.js --node-resolve --esbuild-target auto

Guide

Check out this step by step guide to get started.

Example projects

Check out the example projects for a fully integrated setup.

Documentation

See our website for full documentation.