Run Jest Tests

Name: run-tests
Rating: 92
Author: jakewaldrip

Quick Reference

bash

npx nx <target> <project> -- --runTestsByPath <relative-path>

Component	How to Determine
`<target>`	`test-local:jest:run` if path contains `/local/`, otherwise `test:jest:run`
`<project>`	Use @nx-project-mapping skill to get project name
`<relative-path>`	Path relative to project root, not repo root

•Use @nx-project-mapping to get the project name and root
•Strip the project root prefix from the file path to get the relative path
•Choose target: test-local:jest:run for /local/ paths, test:jest:run otherwise
•Run the command

File Path	Project	Relative Path	Command
`commons-packages/backend/__tests__/services/member.spec.ts`	`@commons/backend`	`__tests__/services/member.spec.ts`	`npx nx test:jest:run @commons/backend -- --runTestsByPath __tests__/services/member.spec.ts`
`packages/athena/__tests__/local/workflow.spec.ts`	`@cityblock/athena`	`__tests__/local/workflow.spec.ts`	`npx nx test-local:jest:run @cityblock/athena -- --runTestsByPath __tests__/local/workflow.spec.ts`

Same project, same target—pass multiple paths:

bash

npx nx test:jest:run @commons/backend -- --runTestsByPath __tests__/a.spec.ts __tests__/b.spec.ts

Omit --runTestsByPath to run all tests:

bash

npx nx test:jest:run @commons/backend

By default, console output is captured and only shown on failure. For live output:

bash

COMMONS_TESTING_LOG_LEVEL=live npx nx test:jest:run <project> -- --runTestsByPath <path>

Log levels: error (default) | warn | info | live

For development, add --watch:

bash

npx nx test:jest:run @commons/backend -- --runTestsByPath __tests__/my.spec.ts --watch

Issue	Solution
EPERM errors	Run with sandbox disabled (permission issues with npm/node modules)
Test not found	Verify path is relative to project root, not repo root
`/local/` tests not running	Use `test-local:jest:run` target instead of `test:jest:run`