forcedotcom/sf-skills / plugins/builder/salesforce-development/skills/platform-apex-test-run
platform-apex-test-run
VerifiedApex test execution, coverage analysis, and test-fix loops with 120-point scoring. Use when the user runs Apex tests, checks code coverage, fixes failing tests, or touches *Test.cls / *_Test.cls files. DO NOT TRIGGER when writing Apex production code (use platform-apex-generate), Agentforce agent testing (use agentforce-test), or Jest/LWC tests (use experience-lwc-generate).
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 3.0 KB |
| SKILL.md | skill md | 7.3 KB |
| assets/basic-test.cls | other | 12.7 KB |
| assets/bulk-test.cls | other | 11.3 KB |
| assets/dml-mock.cls | other | 12.6 KB |
| assets/mock-callout-test.cls | other | 13.6 KB |
| assets/stub-provider-example.cls | other | 12.2 KB |
| assets/test-data-factory.cls | other | 14.3 KB |
| references/cli-commands.md | markdown | 5.7 KB |
| references/mocking-patterns.md | markdown | 13.2 KB |
| references/performance-optimization.md | markdown | 7.5 KB |
| references/test-fix-loop.md | markdown | 2.0 KB |
| references/test-patterns.md | markdown | 4.2 KB |
| references/testing-best-practices.md | markdown | 15.6 KB |
| scripts/parse-test-results.py | script | 12.8 KB |
references/cli-commands.md
View on GitHub<!-- Parent: platform-apex-test-run/SKILL.md -->
# Salesforce CLI Test Commands Reference
## Quick Reference
| Task | Command |
|------|---------|
| Run single test class | `sf apex run test --class-names MyTest` |
| Run all local tests | `sf apex run test --test-level RunLocalTests` |
| Run with coverage | `sf apex run test --class-names MyTest --code-coverage` |
| Get JSON output | `sf apex run test --class-names MyTest --result-format json` |
| Run specific methods | `sf apex run test --tests MyTest.method1 --tests MyTest.method2` |
## Test Execution
### Run Single Test Class
```bash
sf apex run test \
--class-names AccountServiceTest \
--target-org my-sandbox \
--code-coverage \
--result-format human
```
### Run Multiple Test Classes
```bash
sf apex run test \
--class-names AccountServiceTest \
--class-names ContactServiceTest \
--class-names LeadServiceTest \
--target-org my-sandbox \
--code-coverage
```
### Run Specific Test Methods
```bash
sf apex run test \
--tests AccountServiceTest.testCreate \
--tests AccountServiceTest.testUpdate \
--target-org my-sandbox
```
### Run All Local Tests
```bash
sf apex run test \
--test-level RunLocalTests \
--target-org my-sandbox \
--code-coverage \
--output-dir test-results
```
### Run Test Suite
```bash
sf apex run test \
--suite-names RegressionSuite \
--target-org my-sandbox \
--code-coverage
```
## Test Levels
| Level | Description |
|-------|-------------|
| `RunSpecifiedTests` | Only specified tests (default when using --class-names) |
| `RunLocalTests` | All tests except managed packages |
| `RunAllTestsInOrg` | All tests including managed packages |
## Output Formats
### Human Readable (Default)
```bash
sf apex run test --class-names MyTest --result-format human
```
### JSON (For Parsing)
```bash
sf apex run test --class-names MyTest --result-format json
```
### JUnit XML (For CI/CD)
```bash
sf apex run test --class-names MyTest --result-format junit
```
### TAP (Test Anything Protocol)
```bash
sf apex run test --class-names MyTest --result-format tap
```
## Code Coverage
### Basic Coverage
```bash
sf apex run test \
--class-names MyTest \
--code-coverage \
--target-org my-sandbox
```
### Detailed Line-by-Line Coverage
```bash
sf apex run test \
--class-names MyTest \
--code-coverage \
--detailed-coverage \
--target-org my-sandbox
```
### Save Results to Directory
```bash
sf apex run test \
--class-names MyTest \
--code-coverage \
--output-dir ./test-results \
--target-org my-sandbox
```
Output files:
- `test-run-id.json` - Test results
- `test-run-id-codecoverage.json` - Coverage data
## Async Test Execution
### Run Tests Asynchronously
```bash
sf apex run test \
--test-level RunLocalTests \
--target-org my-sandbox \
--async
```
Returns a test run ID for checking status later.
### Check Async Test Status
```bash
sf apex get test \
--test-run-id 707xx0000000000AAA \
--target-org my-sandbox
```
### Wait for Test Completion
```bash
sf apex run test \
--test-level RunLocalTests \
--target-org my-sandbox \
--wait 10 # Wait up to 10 minutes
```
## Debug Logs During Tests
### Enable Debug Logs
```bash
# List current log levels
sf apex list log --target-org my-sandbox
# Tail logs in real-time
sf apex tail log --target-org my-sandbox --color
```
### Get Specific Log
```bash
sf apex get log \
--log-id 07Lxx0000000000AAA \
--target-org my-sandbox
```
## Useful Flags
| Flag | Description |
|------|-------------|
| `--code-coverage` | Include coverage in results |
| `--detailed-coverage` | Line-by-line coverage (slower) |
| `--result-format` | Output format (human, json, junit, tap) |
| `--output-dir` | Save results to directory |
| `--synchronous` | Wait for completion (default) |
| `--wait` | Max minutes to wait |
| `--async` | Return immediately with run ID |
| `--verbose` | Show additional details |
| `--concise` | Suppress passing test details (show only failures) |
| `--poll-interval <seconds>` | Customize polling interval (v2.116.6+) |
## Common Patterns
### Full Test Run with Coverage Report
```bash
sf apex run test \
--test-level RunLocalTests \
--code-coverage \
--result-format json \
--output-dir ./test-results \
--target-org my-sandbox \
--wait 30
```
### Quick Validation (Single Test)
```bash
sf apex run test \
--tests AccountServiceTest.testCreate \
--target-org my-sandbox
```
### CI/CD Pipeline Pattern
```bash
# Run tests with JUnit output for CI tools
sf apex run test \
--test-level RunLocalTests \
--result-format junit \
--output-dir ./test-results \
--code-coverage \
--target-org ci-sandbox \
--wait 60
# Check exit code
if [ $? -ne 0 ]; then
echo "Tests failed!"
exit 1
fi
```
### Coverage Validation
```bash
# Run tests and check minimum coverage
sf apex run test \
--test-level RunLocalTests \
--code-coverage \
--result-format json \
--output-dir ./test-results \
--target-org my-sandbox
# Parse coverage from JSON (requires jq)
coverage=$(jq '.result.summary.orgWideCoverage' ./test-results/*.json | tr -d '"' | tr -d '%')
if [ "$coverage" -lt 75 ]; then
echo "Coverage $coverage% is below 75% threshold!"
exit 1
fi
```
## Troubleshooting
### Test Timeout
```bash
# Increase wait time for long-running tests
sf apex run test \
--test-level RunAllTestsInOrg \
--wait 120 \
--target-org my-sandbox
```
### No Test Results
Check if tests exist:
```bash
sf data query --query "SELECT Id, Name FROM ApexClass WHERE Name LIKE '%Test%'" --target-org my-sandbox
```
### Permission Errors
Ensure user has "Author Apex" permission and API access.
### Async Test Not Completing
Check system status:
```bash
sf apex get test \
--test-run-id 707xx0000000000AAA \
--target-org my-sandbox
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |