Node.js `node:test` の台頭 - 2025 年の Jest への挑戦者か？

はじめに

JavaScript 開発の急速に進化する状況において、テストは堅牢で保守可能なアプリケーションの礎であり続けます。長年にわたり、Jest のようなフレームワークがテストシーンを支配し、包括的な機能スイートと成熟したエコシステムを提供してきました。しかし、JavaScript のランタイム環境の中心から新しい挑戦者が現れました。それが Node.js の組み込みテストランナー node:test です。2025 年が近づくにつれて、次のような重要な疑問が生じます。node:test はすでに成熟しているのか、それとも Jest の優位性に挑戦し、Node.js プロジェクトの事実上のテストソリューションになるのは時間の問題なのでしょうか？開発者がよりシンプルで、より統合され、潜在的によりパフォーマンスの高いテストツールを求める中、この議論はますます重要になっています。ネイティブソリューションが開発ワークフローを合理化し、依存関係のオーバーヘッドを削減する可能性は計り知れず、その現在の状況と将来の軌道を理解することは、情報に基づいたアーキテクチャ上の意思決定を行う上で不可欠です。

テストの状況: コアコンセプトと競合

node:test と Jest の具体論に入る前に、いくつかのコアコンセプトを簡単に定義し、主要なプレイヤーを紹介しましょう。

テストフレームワーク: テストの記述と実行のための構造を提供するソフトウェアフレームワーク。通常、アサーションライブラリ、テストランナー、およびレポーティングメカニズムが含まれます。

テストランナー: テストの実行を調整し、テストファイルを検出し、それらを実行し、結果を報告するコンポーネント。

アサーションライブラリ: テスト中に特定の条件が満たされていることをアサートするために使用される関数のセット。たとえば、expect(a).toBe(b) は a が b に等しいことをアサートします。

モック/スパイ: テスト中にコードの単位を分離するために使用される技術。モックは実際の依存関係を制御されたバージョンに置き換えますが、スパイは実装を変更せずに直接の動作を観察します。

カバレッジレポーティング: テストによってコードベースのどの程度が実行されたかを示すメトリック。

Jest: 確立されたチャンピオン

Jest は、Facebook (現 Meta) によって開発された、人気があり機能豊富な JavaScript テストフレームワークです。セットアップの容易さ、優れたドキュメント、「すぐに使える」アプローチで知られており、テストランナー、アサーションライブラリ、モックユーティリティ、カバレッジレポーティングをすぐに利用できます。

// example.test.js (Jest)
function sum(a, b) {
  return a + b;
}

describe('sum function', () => {
  test('adds 1 + 2 to equal 3', () => {
    expect(sum(1, 2)).toBe(3);
  });

  test('handles zero correctly', () => {
    expect(sum(0, 0)).toBe(0);
  });
});

node:test: ネイティブ挑戦者

Node.js v18 で導入され、v20 で安定化された node:test は、Node.js の組み込みテストランナーです。その主な魅力は、ネイティブ統合にあり、基本的なテストニーズのために外部依存関係を必要としません。Node.js のモジュールシステムを活用し、シンプルで Promise ベースの API を提供します。

// example.test.js (node:test)
import test from 'node:test';
import assert from 'node:assert';

function sum(a, b) {
  return a + b;
}

test('sum function', async (t) => {
  await t.test('adds 1 + 2 to equal 3', () => {
    assert.strictEqual(sum(1, 2), 3);
  });

  await t.test('handles zero correctly', () => {
    assert.strictEqual(sum(0, 0), 0);
  });
});

この node:test の例を実行するには、ターミナルから node --test example.test.js を実行するだけです。

node:test の原則

node:test の根幹となる原則は、シンプルさとネイティブ統合です。軽量でパフォーマンスの高いテストソリューションを提供することを目的としており、Node.js のインストールとともに常に利用できます。テストファイルがテスト対象のコードの隣に配置できる分散型テストアプローチを奨励します。テスト実行のために非同期のオブザーバーベースのモデルを使用しており、並列テスト実行と標準出力経由の柔軟なレポート作成を可能にします。

機能比較: Jest vs. node:test

それぞれの位置を理解するために、主要な機能を分解してみましょう。

1. セットアップと依存関係:

• Jest: インストールが必要 (npm install --save-dev jest)。package.json の設定が含まれます。
• node:test: インストール不要。Node.js v18+ で直接利用可能。これは、小規模なプロジェクトや厳格な依存関係ポリシーを持つ環境にとって大きな利点です。

2. アサーションライブラリ:

• Jest: 独自の強力な expect アサーションライブラリが付属しており、非常に読みやすく拡張可能です。
• node:test: 組み込みの node:assert モジュールに依存しています。機能的ですが、Jest の expect よりも冗長で機能が豊富ではありません。ただし、Chai のような任意の外部アサーションライブラリを node:test で使用することもできます。

// Chai を node:test で使用
import test from 'node:test';
import { expect } from 'chai';

test('assertions with Chai', () => {
  expect(1 + 1).to.equal(2);
});

3. モックとスパイ:

• Jest: モジュールモックと関数オーバーライドをシームレスに処理する洗練されたモッキングシステム (jest.fn(), jest.spyOn(), jest.mock()) を提供します。
• node:test: ネイティブでモッキングユーティリティを提供しません。開発者は、手動モックを実装するか、より複雑なモッキングシナリオのためにサードパーティライブラリ (例: sinon.js) に依存する必要があります。

// node:test での手動モック
import test from 'node:test';
import assert from 'node:assert';
import sinon from 'sinon'; // 'npm install sinon' が必要

class Database {
  save(data) {
    // ここで実際の DB と通信すると想像してください
    return 'Saved: ' + data;
  }
}

test('mocking with sinon', async (t) => {
  const db = new Database();
  const saveStub = sinon.stub(db, 'save').returns('Mocked Save');

  await t.test('should call the mocked save method', () => {
    const result = db.save('test data');
    assert.strictEqual(result, 'Mocked Save');
    assert.ok(saveStub.calledOnce);
  });

  saveStub.restore(); // スタブをクリーンアップ
});

4. テストランナー機能:

• Jest: ファイルを監視し、影響を受けるテストをインテリジェントに再実行し、並列実行をサポートし、テストフィルタリングのためのインタラクティブな UI を提供します。
• node:test: デフォルトで並列実行をサポートします。基本的な only と skip オプションが含まれています。ファイル監視やより高度なインタラクティブモードは組み込まれていませんが、外部監視ツールで実現するか、テストランナーをラップすることで実現できます。

// 'only' と 'skip' を使用した node:test
import test from 'node:test';
import assert from 'node:assert';

test('this test will run', () => {
  assert.ok(true);
});

test('this test will also run');

test('this test will be skipped by default', { skip: true }, () => {
  // このブロックは実行されません
});

test('only this test will run if --test-name-pattern is used', { only: true }, () => {
  assert.equal(1, 1);
});

only: true とマークされたテストのみを実行するには、`node --test --test-name-pattern