UNPKG

@web/test-runner

Version:
66 lines (44 loc) • 2.08 kB
# Web Test Runner Test runner for web applications. šŸ‘‰&nbsp;&nbsp; Headless browsers with [Puppeteer](browsers/puppeteer.md), [Playwright](browsers/playwright.md), or [Selenium](browsers/selenium.md). <br> 🚧&nbsp;&nbsp; Reports logs, 404s, and errors from the browser. <br> šŸ”&nbsp;&nbsp; Debug opens a real browser window with devtools.<br> šŸ“¦&nbsp;&nbsp; Mock es modules using [Import Maps](./writing-tests/mocking.md).<br> šŸ”§&nbsp;&nbsp; Exposes browser properties like viewport size and dark mode.<br> ā±&nbsp;&nbsp;Runs tests in parallel and isolation.<br> šŸ‘€&nbsp;&nbsp; Interactive watch mode.<br> šŸƒ&nbsp;&nbsp; Fast development by rerunning only changed tests.<br> šŸš€&nbsp;&nbsp; Powered by [esbuild](/docs/dev-server/plugins/esbuild.md) and [rollup plugins](/docs/dev-server/plugins/rollup.md) See [our website](https://modern-web.dev/docs/test-runner/overview/) 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](../../docs/guides/test-runner/getting-started.md) to get started. ## Example projects Check out the <a href="https://github.com/modernweb-dev/example-projects" target="_blank" rel="noopener noreferrer">example projects</a> for a fully integrated setup. ## Documentation See [our website](https://modern-web.dev/docs/test-runner/overview/) for full documentation.