| name | test |
| description | Advanced test implementation command with unit/E2E support, auto-execution, and smart fixing capabilities |
Test Command
Implement comprehensive tests with optional test execution and intelligent failure fixing.
Usage
/test <target> [options]
Target Specification
| Target Type | Examples | Description |
|---|
| Component Name | LoginForm, UserProfile | React/Vue/Angular components |
| File Path | utils/validation, hooks/useAuth | Module and utility files |
| Function Name | calculateTotal, formatDate | Specific functions |
| Feature Name | authentication, payment | Entire feature areas |
Options
| Option | Description | Default |
|---|
-u | Unit test mode | ✅ |
-e | E2E test mode + accessibility injection | - |
-r | Auto-run tests with smart fixing | - |
-v | Verbose output mode | - |
-c | Coverage-focused mode (target 90%+) | - |
-p | Performance test mode | - |
-w | Watch mode | - |
-f | Fast mode (parallel + caching) | - |
--files=PATTERN | Specify files by glob | - |
--exclude=PATTERN | Exclude files by glob | - |
--include-deps | Include dependency files | - |
--dry-run | Test design only | - |
Tool Priorities
ALWAYS prioritize mcp__serena__ tools over default Claude Code tools:
File Operations (Serena MCP First)
- Reading files: Use
mcp__serena__find_file → Read (fallback)
- Searching patterns: Use
mcp__serena__search_for_pattern → Grep (fallback)
- Finding symbols: Use
mcp__serena__find_symbol → Glob (fallback)
Code Analysis (Serena MCP)
- Symbol overview: Use
mcp__serena__get_symbols_overview
- Symbol references: Use
mcp__serena__find_referencing_symbols
- Code replacement: Use
mcp__serena__replace_symbol_body → Edit (fallback)
Examples
/test LoginComponent -e -r
/test utils/auth -u -r -c
/test PaymentForm -e -v
/test components --files="Button*" -u -r
/test src --files="**/*.hook.ts" -u -c
/test api --files="**/*Controller.ts" --include-deps -u -r
/test heavyComponent -u -p -f --parallel=8
/test api/bulk -u -p --timeout=60
Test Implementation Flow
Unit Test Mode (-u)
- Target code analysis with Serena MCP
- Test framework detection (Jest, Vitest, Mocha)
- Test case creation: happy path, error cases, edge cases
E2E Test Mode (-e)
- Component analysis for interactive elements
- E2E framework detection (Cypress, Playwright)
- Accessibility attribute injection (data-testid, aria-label)
- E2E test case creation: page loading, user interactions, forms
Smart Fixing (-r option)
- Parse error output
- Classify errors: syntax, assertion, async, mock, E2E-specific
- Apply appropriate fixing strategy
- Re-run and iterate (max 10 attempts)
Output Report
📁 Created/Updated Files:
- src/components/LoginForm.test.tsx
- cypress/e2e/user-authentication.cy.ts
🧪 Implemented Test Cases:
[Unit Tests]
✓ LoginForm happy path tests (3 cases)
✓ LoginForm error handling tests (2 cases)
🚀 Test Execution Results:
[1st Run] ❌ 2 failures
[Auto-Fix Applied] ✅
[2nd Run] ✅ All passed (9 tests)
Coverage: 95.2%