Initial commit
This commit is contained in:
@@ -0,0 +1,105 @@
|
||||
# tests/[test-type]/
|
||||
|
||||
<!-- Replace [test-type] with: unit, integration, e2e, etc. -->
|
||||
|
||||
This directory contains [test type] tests for [what is being tested].
|
||||
|
||||
## Overview
|
||||
|
||||
<!-- Explain what these tests cover and their purpose -->
|
||||
|
||||
## Test Structure
|
||||
|
||||
```
|
||||
[test-type]/
|
||||
├── subdirectory1/ # Tests for X
|
||||
├── subdirectory2/ # Tests for Y
|
||||
└── helpers/ # Test utilities and fixtures
|
||||
```
|
||||
|
||||
## Running Tests
|
||||
|
||||
```bash
|
||||
# All tests in this directory
|
||||
npm run test:[test-type]
|
||||
|
||||
# Specific test file
|
||||
npm run test:[test-type] -- path/to/test.test.ts
|
||||
|
||||
# Watch mode
|
||||
npm run test:[test-type]:watch
|
||||
```
|
||||
|
||||
## Test Environment
|
||||
|
||||
<!-- Describe the test environment setup -->
|
||||
|
||||
These tests use:
|
||||
- **Database**: [Description]
|
||||
- **External Services**: [How mocked/handled]
|
||||
- **Test Data**: [Where fixtures are located]
|
||||
|
||||
## Patterns
|
||||
|
||||
### Test Structure
|
||||
|
||||
<!-- Show the typical test structure -->
|
||||
|
||||
```typescript
|
||||
describe('Feature Name', () => {
|
||||
beforeEach(() => {
|
||||
// Setup
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
// Cleanup
|
||||
});
|
||||
|
||||
it('should do something', () => {
|
||||
// Arrange
|
||||
// Act
|
||||
// Assert
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
### Fixtures and Factories
|
||||
|
||||
<!-- How to use test data -->
|
||||
|
||||
```typescript
|
||||
import { fixtures } from './fixtures';
|
||||
|
||||
const user = fixtures.user();
|
||||
const admin = fixtures.user({ role: 'admin' });
|
||||
```
|
||||
|
||||
## Common Patterns
|
||||
|
||||
<!-- Document common testing patterns used -->
|
||||
|
||||
- Pattern 1: Description
|
||||
- Pattern 2: Description
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
<!-- Common issues and solutions -->
|
||||
|
||||
### Issue 1
|
||||
|
||||
Problem description and solution.
|
||||
|
||||
### Issue 2
|
||||
|
||||
Problem description and solution.
|
||||
|
||||
## Notes
|
||||
|
||||
<!-- Additional context -->
|
||||
|
||||
- Important note about test conventions
|
||||
- Known limitations
|
||||
|
||||
---
|
||||
|
||||
*Last Updated: YYYY-MM-DD*
|
||||
Reference in New Issue
Block a user