| name | test-frontend-unit |
| version | 1.0.0 |
| description | Run frontend unit tests without coverage analysis (fast execution) |
| author | Charon Project |
| license | MIT |
| tags | testing, unit-tests, frontend, vitest, fast |
| compatibility | [object Object] |
| requirements | [object Object], [object Object] |
| environment_variables | |
| parameters | [object Object], [object Object] |
| outputs | [object Object] |
| metadata | [object Object] |
Test Frontend Unit
Overview
Executes the frontend unit test suite using Vitest without coverage analysis. This skill provides fast test execution for quick feedback during development, making it ideal for pre-commit checks and rapid iteration.
Unlike test-frontend-coverage, this skill does not generate coverage reports or enforce coverage thresholds, focusing purely on test pass/fail status.
Prerequisites
- Node.js 18.0 or higher installed and in PATH
- npm 9.0 or higher installed and in PATH
- Frontend dependencies installed (
cd frontend && npm install)
Usage
Basic Usage
Run all frontend unit tests:
cd /path/to/charon
.github/skills/scripts/skill-runner.sh test-frontend-unit
Watch Mode
Run tests in watch mode for continuous testing:
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
Filter Tests
Run tests matching a specific pattern:
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --grep "Button"
CI/CD Integration
For use in GitHub Actions or other CI/CD pipelines:
- name: Run Frontend Unit Tests
run: .github/skills/scripts/skill-runner.sh test-frontend-unit
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| watch | boolean | No | false | Run tests in watch mode |
| filter | string | No | "" | Filter tests by name pattern |
Environment Variables
No environment variables are required for this skill.
Outputs
Success Exit Code
- 0: All tests passed
Error Exit Codes
- Non-zero: One or more tests failed
Console Output
Example output:
✓ src/components/Button.test.tsx (3)
✓ src/utils/helpers.test.ts (5)
✓ src/hooks/useAuth.test.ts (4)
Test Files 3 passed (3)
Tests 12 passed (12)
Examples
Example 1: Basic Execution
.github/skills/scripts/skill-runner.sh test-frontend-unit
Example 2: Watch Mode for TDD
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --watch
Example 3: Test Specific File
.github/skills/scripts/skill-runner.sh test-frontend-unit -- Button.test.tsx
Example 4: UI Mode (Interactive)
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --ui
Example 5: Reporter Configuration
.github/skills/scripts/skill-runner.sh test-frontend-unit -- --reporter=verbose
Error Handling
Common Errors
Error: Cannot find module
Solution: Run npm install to ensure all dependencies are installed
Error: Test timeout
Solution: Increase timeout in vitest.config.ts or fix hanging async tests
Error: Unexpected token
Solution: Check for syntax errors in test files
Related Skills
- test-frontend-coverage - Run tests with coverage analysis (slower)
- test-backend-unit - Backend Go unit tests
- build-check-go - Verify builds without running tests
Notes
- Execution Time: Fast execution (~3-5 seconds typical)
- No Coverage: Does not generate coverage reports
- Vitest Features: Full access to Vitest CLI options via arguments
- Idempotency: Safe to run multiple times
- Caching: Benefits from Vitest's smart caching
- Suitable For: Pre-commit hooks, quick feedback, TDD workflows
- Watch Mode: Available for interactive development
Last Updated: 2025-12-20 Maintained by: Charon Project Team Source: Inline task command