# Playwright module arguments Generated from [the CLI catalog](../../lib/cli/catalog.json). Every export requires a fresh `runDir`. Common fields are `project` (default `.`), `executable` (the CLI program or path), `timeoutMs` (default `900000`), and `artifacts` (an object mapping output names to file paths). ## `run` Execute arbitrary literal CLI arguments. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `arguments` | `strings` | `` | Required | ## `version` Print the CLI version. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | ## `setup` Install the test framework in project using Bun. Browser binaries are installed separately with install. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `version` | `string` | `@playwright/test@` | `"latest"` | ## `test` Run Playwright Test headlessly, optionally filtering projects and tests. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `config` | `string` | `--config=` | Omitted | | `testProject` | `strings` | `--project=` | Omitted | | `grep` | `string` | `--grep=` | Omitted | | `grepInvert` | `string` | `--grep-invert=` | Omitted | | `workers` | `integer` | `--workers=` | Omitted | | `reporter` | `string` | `--reporter=` | Omitted | | `output` | `string` | `--output=` | Omitted | | `retries` | `integer` | `--retries=` | Omitted | | `shard` | `string` | `--shard=` | Omitted | | `forbidOnly` | `boolean` | `--forbid-only` | Omitted | | `failOnFlakyTests` | `boolean` | `--fail-on-flaky-tests` | Omitted | | `updateSnapshots` | `boolean` | `--update-snapshots` | Omitted | | `tests` | `strings` | `` | `[]` | ## `list` List matching tests without launching browsers. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `config` | `string` | `--config=` | Omitted | | `testProject` | `strings` | `--project=` | Omitted | | `grep` | `string` | `--grep=` | Omitted | | `grepInvert` | `string` | `--grep-invert=` | Omitted | | `workers` | `integer` | `--workers=` | Omitted | | `tests` | `strings` | `` | `[]` | ## `install` Install browser binaries matching the installed Playwright package. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `withDeps` | `boolean` | `--with-deps` | Omitted | | `onlyShell` | `boolean` | `--only-shell` | Omitted | | `browsers` | `strings` | `` | `[]` | ## `install_deps` Install operating-system browser dependencies; may require elevated privileges. | Field | Type | CLI argument | Default / required | | --- | --- | --- | --- | | `browsers` | `strings` | `` | `[]` |