nx/docs/web/nx-commands/affected-test.md

124 lines
1.8 KiB
Markdown

# affected:test
Test projects affected by changes
## Usage
```bash
nx affected:test
```
Install `@nrwl/cli` globally to invoke the command directly using `nx`, or use `npm run nx` or `yarn nx`.
### Examples
Run tests in parallel:
```bash
nx affected:test --parallel --maxParallel=5
```
Rerun the test target only for the projects that failed last time:
```bash
nx affected:test --only-failed
```
Run the test target for all projects:
```bash
nx affected:test --all
```
Run tests for all the projects affected by changing the index.ts file:
```bash
nx affected:test --files=libs/mylib/src/index.ts
```
Run tests for all the projects affected by the changes between master and HEAD (e.g., PR):
```bash
nx affected:test --base=master --head=HEAD
```
Run tests for all the projects affected by the last commit on master:
```bash
nx affected:test --base=master~1 --head=master
```
## Options
### all
All projects
### base
Base of the current branch (usually master)
### configuration
This is the configuration to use when performing tasks on projects
### exclude
Default: ``
Exclude certain projects from being processed
### files
Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
### head
Latest commit of the current branch (usually HEAD)
### help
Show help
### maxParallel
Default: `3`
Max number of parallel processes
### only-failed
Default: `false`
Isolate projects which previously failed
### parallel
Default: `false`
Parallelize the command
### plain
Produces a plain output for affected:apps and affected:libs
### runner
This is the name of the tasks runner configured in nx.json
### uncommitted
Uncommitted changes
### untracked
Untracked changes
### verbose
Print additional error stack trace on failure
### version
Show version number