affected
Run target for affected projects
Usage
nx affected
Install nx
globally to invoke the command directly using nx
, or use npx nx
, yarn nx
, or pnpm nx
.
Examples
Run custom target for all affected projects:
nx affected --target=custom-target```
Run tests in parallel:
```bash
nx affected --target=test --parallel=5```
Run the test target for all projects:
```bash
nx affected --target=test --all```
Run tests for all the projects affected by changing the index.ts file:
```bash
nx affected --target=test --files=libs/mylib/src/index.ts```
Run tests for all the projects affected by the changes between main and HEAD (e.g., PR):
```bash
nx affected --target=test --base=main --head=HEAD```
Run tests for all the projects affected by the last commit on main:
```bash
nx affected --target=test --base=main~1 --head=main```
## Options
### all
Type: `boolean`
All projects
### base
Type: `string`
Base of the current branch (usually main)
### configuration
Type: `string`
This is the configuration to use when performing tasks on projects
### exclude
Type: `array`
Default: `[]`
Exclude certain projects from being processed
### files
Type: `array`
Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
### head
Type: `string`
Latest commit of the current branch (usually HEAD)
### help
Type: `boolean`
Show help
### nx-bail
Type: `boolean`
Default: `false`
Stop command execution after the first failed task
### nx-ignore-cycles
Type: `boolean`
Default: `false`
Ignore cycles in the task graph
### output-style
Type: `string`
Choices: [dynamic, static, stream, stream-without-prefixes]
Defines how Nx emits outputs tasks logs
### parallel
Type: `string`
Max number of parallel processes [default is 3]
### runner
Type: `string`
This is the name of the tasks runner configured in nx.json
### skip-nx-cache
Type: `boolean`
Default: `false`
Rerun the tasks even when the results are available in the cache
### target
Type: `string`
Task to run for affected projects
### uncommitted
Type: `boolean`
Uncommitted changes
### untracked
Type: `boolean`
Untracked changes
### verbose
Type: `boolean`
Default: `false`
Prints additional information about the commands (e.g., stack traces)
### version
Type: `boolean`
Show version number