Here are the most common options available in the command line.
Run all the tests
npx playwright test
Run a single test file
npx playwright test tests/todo-page.spec.ts
Run a set of test files
npx playwright test tests/todo-page/ tests/landing-page/
Run files that have
my-spec-2in the file name
npx playwright test my-spec my-spec-2
Run files that are in line 42 in my-spec.ts
npx playwright test my-spec.ts:42
Run the test with the title
npx playwright test -g "add a todo item"
Run tests in headed browsers
npx playwright test --headed
Run all the tests against a specific project
npx playwright test --project=chromium
npx playwright test --workers=1
Choose a reporter
npx playwright test --reporter=dot
Run in debug mode with Playwright Inspector
npx playwright test --debug
Ask for help
npx playwright test --help
Complete set of Playwright Test options is available in the configuration file. Following options can be passed to a command line and take a priority over the configuration file:
--headed: Run tests in headed browsers. Useful for debugging.
--browser: Run test in a specific browser. Available options are
"all"to run tests in all three browsers at the same time.
--debug: Run tests with Playwright Inspector. Shortcut for
PWDEBUG=1environment variable and
--timeout=0 --maxFailures=1 --headed --workers=1options.
--config <file>: Configuration file. If not passed, defaults to
playwright.config.jsin the current directory.
--config <dir>: Directory with the tests to run without configuration file.
--forbid-only: Whether to disallow
test.only. Useful on CI.
--grep <grep>: Only run tests matching this regular expression. For example, this will run
'should add to cart'when passed
-g "add to cart".
--grep-invert <grep>: Only run tests not matching this regular expression. The opposite of
--global-timeout <number>: Total timeout for the whole test run in milliseconds. By default, there is no global timeout. Learn more about various timeouts.
--list: List all the tests, but do not run them.
-x: Stop after the first
Ntest failures. Passing
-xstops after the first failure.
--output <dir>: Directory for artifacts produced by tests, defaults to
--project <name>: Only run tests from one of the specified projects. Defaults to running all projects defined in the configuration file.
--quiet: Whether to suppress stdout and stderr from the tests.
--repeat-each <N>: Run each test
Ntimes, defaults to one.
--reporter <reporter>: Choose a reporter: minimalist
list. See reporters for more information.
--retries <number>: The maximum number of retries for flaky tests, defaults to zero (no retries).
--shard <shard>: Shard tests and execute only selected shard, specified in the form
current/all, 1-based, for example
--timeout <number>: Maximum timeout in milliseconds for each test, defaults to 30 seconds. Learn more about various timeouts.
-i: Whether to ignore snapshots. Use this when snapshot expectations are known to be different, e.g. running tests on Linux against Windows screenshots.
-u: Whether to update snapshots with actual results instead of comparing them. Use this when snapshot expectations have changed.
-j <number>: The maximum number of concurrent worker processes that run in parallel.