run-test

name	run-test
description	Run tests. Supports running all tests, single file, or pattern-matched tests.
argument-hint	["file-path|pattern"]
disable-model-invocation	true
allowed-tools	Bash(pnpm test*), Bash(cd *), Read, Glob

Run Tests

Run project tests. Arguments: $ARGUMENTS

Test Commands

Run All Tests

pnpm test

Run Single Test File

# Using relative path (from apps/core directory)
pnpm test -- test/src/modules/post/post.controller.e2e-spec.ts

# Using filename pattern
pnpm test -- --testNamePattern="PostController"

Watch Mode

pnpm -C apps/core run test:watch

Run Specific Test Case

# Match test name
pnpm test -- --testNamePattern="should create post"

Test Directory Structure

apps/core/test/
├── src/
│   ├── modules/           # Module tests
│   │   ├── post/
│   │   │   ├── post.controller.e2e-spec.ts
│   │   │   └── post.e2e-mock.db.ts
│   │   ├── user/
│   │   │   ├── user.controller.spec.ts
│   │   │   ├── user.controller.e2e-spec.ts
│   │   │   └── user.service.spec.ts
│   │   └── ...
│   ├── utils/             # Utility tests
│   ├── processors/        # Processor tests
│   └── transformers/      # Transformer tests
├── helper/                # Test helpers
├── mock/                  # Mock implementations
└── setup-global.ts        # Global setup

Test Types

Suffix	Type	Description
.spec.ts	Unit test	Test single function or class
.e2e-spec.ts	E2E test	Test complete HTTP request flow

Execution Steps

1. Analyze arguments to determine which tests to run
2. If file path specified, verify file exists first
3. Execute appropriate test command
4. Report test results

Common Issues

Test Timeout

Increase timeout:

pnpm test -- --testTimeout=30000

Memory Issues

Tests use in-memory database. If memory issues occur:

NODE_OPTIONS="--max-old-space-size=4096" pnpm test

Run Only Failed Tests

pnpm test -- --reporter=verbose