Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Disposable Postgres με @testcontainers/postgresql 12: start container, σύνδεση με getConnectionUri, migrations, καθαρισμός — και πότε αρκεί το docker compose.
Τα unit tests δεν πιάνουν λάθος SQL, ξεχασμένο migration και στραβό constraint. Η λύση δεν είναι να mockάρετε τη βάση — είναι να σηκώνετε αληθινό PostgreSQL σε disposable container για κάθε run και να το πετάτε μετά. Με το @testcontainers/postgresql 12 (τρέχουσα έκδοση 12.2.1 στο npm) αυτό είναι δέκα γραμμές.
npm install @testcontainers/postgresql@12.2.1 pg@8.23.1 --save-dev// src/lib/lessons.integration.test.ts
import { PostgreSqlContainer } from '@testcontainers/postgresql';
import { Client } from 'pg';
import { afterAll, beforeAll, expect, it } from 'vitest';
let container: Awaited<ReturnType<PostgreSqlContainer['start']>>;
let client: Client;
beforeAll(async () => {
container = await new PostgreSqlContainer('postgres:17-alpine')
.withDatabase('app_test')
.start();
client = new Client({ connectionString: container.getConnectionUri() });
await client.connect();
await client.query(
'CREATE TABLE lessons (id TEXT PRIMARY KEY, title TEXT NOT NULL)'
);
}, 120000);
afterAll(async () => {
await client.end();
await container.stop();
});Το new PostgreSqlContainer('postgres:17-alpine') τραβάει το επίσημο image (ίδια οικογένεια με το postgres:17-alpine του production compose), το .withDatabase('app_test') φτιάχνει απομονωμένη βάση, και το getConnectionUri() δίνει έτοιμο connection string για τον pg Client (έκδοση 8.23.1). Το timeout των 120 δευτερολέπτων στο beforeAll καλύπτει το πρώτο pull του image — στα επόμενα runs το image είναι cached.
it('αποθηκεύει και διαβάζει μάθημα', async () => {
await client.query(
'INSERT INTO lessons (id, title) VALUES ($1, $2)',
['l-1', 'Intro']
);
const res = await client.query('SELECT title FROM lessons WHERE id = $1', ['l-1']);
expect(res.rows[0]).toEqual({ title: 'Intro' });
});Παραμετροποιημένα queries ($1, $2) — ποτέ string interpolation, ούτε στα tests: το test πρέπει να μοιάζει με production κώδικα, αλλιώς τεστάρετε κάτι άλλο από αυτό που τρέχει.
app_test) — ποτέ η development βάση.Αν δεν θέλετε Testcontainers, σηκώστε Postgres με compose όπως στο cheatsheet και στο production compose μάθημα: ένα db service με healthcheck pg_isready και ξεχωριστή test βάση. Πιο χειροκίνητο (εσείς διαχειρίζεστε lifecycle), αλλά μηδενικές εξαρτήσεις.
start με await σε beforeAll (γενναιόδωρο timeout για το πρώτο pull), ξεχωριστή βάση, schema από migrations, stop σε afterAll.db service με pg_isready healthcheck.