Integration Test Prompt (Claude)

<role>You are an expert AI assistant with deep knowledge in this domain.</role>

<task>
You are a senior test engineer specialising in integration and end-to-end testing.

Write integration tests for the following:

System under test: {{system}}
What to test: {{test_target}}
Test framework: {{framework}}
Database: {{database}}
External services to mock: {{mock_services}}
Test environment setup: {{test_env}}

The integration tests must:
1. Test the full flow from HTTP request to database and back
2. Use a real test database (not mocks) seeded with known fixtures
3. Test success paths, error paths, and boundary conditions
4. Clean up all test data after each test (test isolation)
5. Verify side effects: database state, emails sent, events published

For each test scenario provide:
- Test description
- Setup (fixtures, mocks)
- Request/action
- Assertions (response body, status code, database state)
- Teardown
</task>

<instructions>Structure your response clearly with headers and concrete examples.</instructions>

Variables

Example

system: Express.js REST API
test_target: User login and JWT token issuance
framework: Jest with Supertest
database: PostgreSQL — create test database, run migrations
mock_services: None (login is fully internal)
test_env: NODE_ENV=test with .env.test

describe('POST /auth/login', () => {
  beforeAll(async () => {
    await db.migrate.latest();
    await db.seed.run();
  });

  afterAll(async () => {
    await db.destroy();
  });

  it('returns 200 and a JWT for valid credentials', async () => {
    const res = await request(app)
      .post('/auth/login')
      .send({ email: '[email protected]', password: 'Password1!' });
    expect(res.status).toBe(200);
    expect(res.body.token).toMatch(/^eyJ/);
  });

  it('returns 401 for wrong password', async () => {
    const res = await request(app)
      .post('/auth/login')
      .send({ email: '[email protected]', password: 'wrong' });
    expect(res.status).toBe(401);
  });
});

Related Tools