97 lines
2.4 KiB
Markdown
97 lines
2.4 KiB
Markdown
---
|
|
name: testing-server-actions
|
|
description: Teaches testing Server Actions in isolation in React 19. Use when testing Server Actions, form handling, or server-side logic.
|
|
allowed-tools: Read, Write, Edit
|
|
version: 1.0.0
|
|
---
|
|
|
|
# Testing Server Actions
|
|
|
|
For Vitest mocking patterns (vi.mock(), vi.fn(), mockResolvedValue), see `vitest-4/skills/writing-vitest-tests/SKILL.md`.
|
|
|
|
## Basic Server Action Test
|
|
|
|
```javascript
|
|
import { submitContact } from './actions';
|
|
|
|
test('submitContact validates email', async () => {
|
|
const formData = new FormData();
|
|
formData.set('email', 'invalid');
|
|
formData.set('message', 'Hello');
|
|
|
|
const result = await submitContact(null, formData);
|
|
|
|
expect(result.error).toBeTruthy();
|
|
});
|
|
|
|
test('submitContact succeeds with valid data', async () => {
|
|
const formData = new FormData();
|
|
formData.set('email', 'test@example.com');
|
|
formData.set('message', 'Hello');
|
|
|
|
const result = await submitContact(null, formData);
|
|
|
|
expect(result.success).toBe(true);
|
|
});
|
|
```
|
|
|
|
## Mocking Database Calls
|
|
|
|
```javascript
|
|
import { createUser } from './actions';
|
|
import { db } from './db';
|
|
|
|
vi.mock('./db', () => ({
|
|
db: {
|
|
users: {
|
|
create: vi.fn(),
|
|
},
|
|
},
|
|
}));
|
|
|
|
test('createUser creates database record', async () => {
|
|
db.users.create.mockResolvedValue({ id: '123', name: 'Alice' });
|
|
|
|
const formData = new FormData();
|
|
formData.set('name', 'Alice');
|
|
formData.set('email', 'alice@example.com');
|
|
|
|
const result = await createUser(null, formData);
|
|
|
|
expect(db.users.create).toHaveBeenCalledWith({
|
|
name: 'Alice',
|
|
email: 'alice@example.com',
|
|
});
|
|
|
|
expect(result.success).toBe(true);
|
|
expect(result.userId).toBe('123');
|
|
});
|
|
```
|
|
|
|
## Testing with Authentication
|
|
|
|
```javascript
|
|
import { deletePost } from './actions';
|
|
import { getSession } from './auth';
|
|
|
|
vi.mock('./auth');
|
|
|
|
test('deletePost requires authentication', async () => {
|
|
getSession.mockResolvedValue(null);
|
|
|
|
await expect(deletePost('post-123')).rejects.toThrow('Unauthorized');
|
|
});
|
|
|
|
test('deletePost checks ownership', async () => {
|
|
getSession.mockResolvedValue({ user: { id: 'user-1' } });
|
|
|
|
await expect(deletePost('post-owned-by-user-2')).rejects.toThrow('Forbidden');
|
|
});
|
|
```
|
|
|
|
For comprehensive Server Action testing, test the function directly in isolation.
|
|
|
|
## References
|
|
|
|
- [@vitest-4/skills/writing-vitest-tests](/vitest-4/skills/writing-vitest-tests/SKILL.md) - Mocking and spy patterns
|