node:testとfetchを使い、一時的なポート上でルートをエンドツーエンドでテストし、各テストが自前のインメモリSQLiteデータベースを持つようにしましょう。
このレッスンを Kodokon で開くNode 20には必要なものすべてが同梱されています。ランナーとしてのnode:test、アサーションのためのnode:assert/strict、HTTPクライアントとしてのグローバルなfetchです。テストの依存はゼロ。そしてここで、最初のレッスンのアーキテクチャが報われます。createApp({ db })は注入されたデータベースを受け取るので、各テストは数ミリ秒で完全な、隔離されたAPIをマウントできます。
node --test
node --test --watchルートをエンドツーエンドでテストするのに、Expressをモックする必要はありません。本物のサーバーをポート0でマウントし、システムが空いているポートを割り当てたら、それをfetchで叩きます。本物のクライアントが目にするものそのもの、ルーティング、ミドルウェア、シリアライズ、ステータスコードを試すのです。これは依存なしの、supertestの精神です。
import { once } from 'node:events';
export async function startTestServer(app) {
const server = app.listen(0);
await once(server, 'listening');
const { port } = server.address();
const url = `http://127.0.0.1:${port}`;
const close = () =>
new Promise((resolve) => {
server.close(resolve);
});
return { url, close };
}テスト用データベースは、メモリ内のSQLite(:memory:)です。各テストはcreateDbを通じて、自前の真っさらで空のデータベースを構築し、それがスキーマを適用します。そして終わりぎわにそれを捨て去ります。テスト間で共有されるデータもなく、クリーンアップのスクリプトもありません。t.afterは、アサーションが失敗したときでもサーバーが閉じられることを保証します。
import test from 'node:test';
import assert from 'node:assert/strict';
import { createDb } from '../src/db/connection.js';
import { createApp } from '../src/app.js';
import { startTestServer } from './helpers.js';
test('POST /api/users creates a user', async (t) => {
const db = createDb(':memory:');
const app = createApp({ db });
const server = await startTestServer(app);
t.after(() => server.close());
const res = await fetch(`${server.url}/api/users`, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
email: 'ada@example.com',
name: 'Ada',
}),
});
assert.equal(res.status, 201);
const body = await res.json();
assert.equal(body.email, 'ada@example.com');
});app.listen(0)で起動するのですか?:memory:データベースの決定的な利点は何ですか?t.afterで閉じるのですか?