---
title: "RunRemixTestOptions"
source: "https://github.com/remix-run/remix/blob/8905f3943706e1f53696ab83e70a84873cabfc90/packages/test/src/cli.ts#L29"
---

# RunRemixTestOptions

## Summary

Options accepted by [`runRemixTest`](/test/cli/function/runRemixTest/).

## Signature

```ts
interface RunRemixTestOptions {
  browser?: { echo?: boolean; open?: boolean }
  concurrency?: string | number
  coverage?:
    | boolean
    | {
        branches?: string | number
        dir?: string
        enabled?: boolean | 'inherit'
        exclude?: string | string[]
        functions?: string | number
        include?: string | string[]
        lines?: string | number
        statements?: string | number
      }
  cwd?: string
  glob?: {
    browser?: string | string[]
    e2e?: string | string[]
    exclude?: string | string[]
    test?: string | string[]
  }
  only?: RemixTestOnlyPattern | RemixTestOnlyPattern[]
  playwrightConfig?: string | PlaywrightTestConfig
  pool?: 'forks' | 'threads'
  project?: string | string[]
  quiet?: boolean
  reporter?: string
  setup?: string
  type?: string | string[]
  watch?: boolean
}

```

## Properties

### `browser`

Options for controlling Playwright browsers.

### `concurrency`

Max number of concurrent test workers (--concurrency)

### `coverage`

Coverage configuration. `true` enables with defaults; an object enables with settings;
`false` disables. CLI `--coverage` flag overrides the boolean aspect.

### `cwd`

Working directory the runner resolves configuration and test files against
(`process.cwd()` by default).

### `glob`

Glob patterns to identify test files. Each field accepts a single pattern
or an array of patterns; arrays are unioned during discovery.
 - `glob.test`: Glob pattern(s) for all test files (--glob.test)
 - `glob.browser`: Glob pattern(s) for the subset of browser test files (--glob.browser)
 - `glob.e2e`: Glob pattern(s) for the subset of e2e test files (--glob.e2e)
 - `glob.exclude`: Glob pattern(s) for paths to exclude from discovery (--glob.exclude)

### `only`

Regular expression pattern(s) to focus tests by their full name (--only).
Matching suite names focus the whole suite, while matching test names focus
the individual test. Plain string patterns are case-insensitive. Use a
slash-delimited pattern or a `RegExp` in programmatic options to control flags
explicitly. `--only` may be repeated on the CLI.

### `playwrightConfig`

Playwright configuration — either a path to a playwright config file or an inline
PlaywrightTestConfig object. CLI `--playwrightConfig` only accepts a file path.

### `pool`

Pool used to run server and E2E test files. Forked child processes are the default,
but worker threads are available for projects that prefer the previous behavior.

### `project`

Filter tests to specific playwright project(s) (--project). Accepts a single
project name or an array of names; `--project` may be repeated on the CLI.

### `quiet`

Quiet mode — do not print skipped tests (--quiet, -q)

### `reporter`

Test reporter (--reporter)

### `setup`

Path to a module that exports `globalSetup` and/or `globalTeardown` functions,
called once before and after the test run respectively. (--setup)

### `type`

Test type(s) to run (--type). Accepts a single type or an array of types;
`--type` may be repeated on the CLI. Valid values: "server", "browser", "e2e".

### `watch`

Watch mode — re-run tests on file changes (--watch)