Files
crumbs/tests/e2e/auth.spec.ts
T
Frederic CabassutandClaude Opus 4.6 590c8f5cae docs: add E2E BDD testing best practices and improve test suite
- Add docs/TESTING.md with 10 BDD testing best practices
- Add createNote() helper to fixtures to DRY up state setup
- Add createChecklistNote() helper in checklist tests
- Rename scenario titles to describe outcomes, not actions
- Replace imperative Given steps with createNote() helper
- Fix fragile conditional in tag filtering test (silent pass)
- Remove implementation details from Gherkin comments
- Improve Given/When/Then rhythm consistency across all tests

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 23:39:29 +01:00

90 lines
3.2 KiB
TypeScript

import { test, expect, setupAndLogin } from './helpers/fixtures.js';
test.describe.serial('Authentication', () => {
test('Scenario: Unauthenticated user is prompted to set up or log in', async ({ page }) => {
// Given a user has not authenticated
// When they access the application
await page.goto('/');
// Then they are directed to the setup or login page
await expect(page).toHaveURL(/\/(setup|login)/);
});
test('Scenario: First-time user sees the account creation form', async ({ page }) => {
// Given no account has been created yet
// When the user visits the setup page
await page.goto('/setup');
// Then the email, password, and confirmation fields and setup action are available
await expect(page.getByTestId('email-input')).toBeVisible();
await expect(page.getByTestId('password-input')).toBeVisible();
await expect(page.getByTestId('confirm-password-input')).toBeVisible();
await expect(page.getByTestId('setup-btn')).toBeVisible();
});
test('Scenario: Account creation is rejected for a password below minimum length', async ({ page }) => {
// Given the user is setting up their account
await page.goto('/setup');
// When they submit a password shorter than 8 characters
await page.getByTestId('email-input').fill('test@test.com');
await page.getByTestId('password-input').fill('short');
await page.getByTestId('confirm-password-input').fill('short');
await page.getByTestId('setup-btn').click();
// Then a validation error is shown
await expect(page.getByTestId('error-message')).toBeVisible();
});
test('Scenario: Account creation is rejected when passwords do not match', async ({ page }) => {
// Given the user is setting up their account
await page.goto('/setup');
// When they submit two different passwords
await page.getByTestId('email-input').fill('test@test.com');
await page.getByTestId('password-input').fill('longpassword1');
await page.getByTestId('confirm-password-input').fill('longpassword2');
await page.getByTestId('setup-btn').click();
// Then a validation error is shown
await expect(page.getByTestId('error-message')).toBeVisible();
});
test('Scenario: User creates an account and gains access to the application', async ({ page }) => {
// Use the shared setupAndLogin helper which handles race conditions
await setupAndLogin(page);
await expect(page.getByTestId('new-note-btn')).toBeVisible();
});
test('Scenario: Logged-out user loses access to the application', async ({ page }) => {
// Given the user is authenticated
await setupAndLogin(page);
// When they log out
await page.evaluate(() => fetch('/api/auth/logout', { method: 'POST' }));
// Then they are redirected to the login page
await page.goto('/');
await expect(page).toHaveURL(/\/login/);
});
});
test.describe('Multi-user', () => {
test('Scenario: Admin-created user is registered successfully', async ({ authenticatedPage: page }) => {
// Given the admin is authenticated
// When the admin creates a new user
const response = await page.request.post('/api/admin/users', {
data: {
email: 'user2@test.com',
displayName: 'User Two',
password: 'userpassword123',
role: 'user'
}
});
// Then the user is created successfully
expect(response.status()).toBe(201);
});
});