Jest 20: 💖 テストが楽しくなる & 🏃🏽 マルチプロジェクトランナー

非公式ベータ版翻訳

このページは PageTurner AI で翻訳されました（ベータ版）。プロジェクト公式の承認はありません。 エラーを見つけましたか？ 問題を報告 →

数ヶ月前に発表したJest 19は主要な新機能を備えた当時最大のリリースでしたが、今日公開するJest 20は前バージョンの2倍の変更を伴い、テストランナーの完全な書き換えを実現し、新たなテストAPIを追加しています。この新リリースはプロジェクトのカスタマイズと設定に新たな次元をもたらすと同時に、アップグレードを驚くほど容易にします。「苦痛のないJavaScriptテスト」を超えて、Jestは今や楽しいJavaScriptテスト体験を提供していると確信しています。主要な新機能と変更点を深掘りしてみましょう：

マルチプロジェクトランナーと設定の大改革

これまでJestは一度に1つのプロジェクトでしか動作できませんでした。これは独自のセットアップと設定を持つ複数の小さなプロジェクトを扱う場合、しばしば煩雑でした。Jest 20ではテストランナーを完全に書き直し、単一のJestインスタンス内で複数のプロジェクトを同時に実行できるようになりました。例えばReactフロントエンドとNode.jsバックエンドを同時に扱う場合などです。こちらはJestがReact、Relay、Yarn、そしてJest自身のテストを同時に実行する様子です：

Jestはターミナルの縦スペースを節約するため、初回テスト実行後に使用ガイドを折りたたむようになりました。

さらに、Jest内部の設定システムを完全に見直しました。設定ファイルで指定したオプションをCLI経由で上書きできるようになりました。同時に、Jestはデフォルトでjest.config.jsファイルを探すように変更され、JavaScriptでJest設定を定義できるようになったほか、従来通りpackage.json経由での設定も可能です。これらの新機能により、これまで以上に強力な方法でJestを組み合わせられます。例えばmonorepo内の複数プロジェクトにまたがるコミットから変更ファイルセットを指定し、Jestが実行するテストを特定したい場合、次のようにCLI引数を組み合わせられます：

$ jest --projects projectA projectB --listTests --findRelatedTests projectA/banana.js projectB/kiwi.js
[
  "projectA/banana.test.js",
  "projectB/kiwi.test.js",
  "projectB/pineapple.test.js",
]

これは継続的インテグレーション（CI）システムで特に有用で、プルリクエストごとにテストのサブセットのみを実行し、小さな変更ごとに数千のテストファイルを実行するのを防げます。

最後に、TypeScript使用時のコードカバレッジを適切にマッピングするようになり、未テストファイルのコードカバレッジをワーカープロセスで実行することで、この機能の大幅な高速化を実現しました。

新機能と改善されたテストAPI

より効果的なテスト作成を支援するため、テストAPIに数多くの追加と改善を行いました。これらの改善はすべてコミュニティメンバーの手によるものだという点を強調しておきます！

• 非同期テストの改善： expectにresolves/rejects修飾子を追加し、async/Promiseをサポート：expect(Promise(…)).resolves.toEqual(…)。ドキュメント参照

• n個のアサーションを期待： 既存のexpect.assertions(n)に加え、新しいexpect.hasAssertions()でテストに少なくとも1つのアサーションがあることを保証可能

• Lintプラグイン： eslint-plugin-jestにvalid-expectルールを追加し、expect呼び出し後にアサーションが確実に呼ばれるようにしました。アサーション呼び出しが欠けたexpect(banana);のようなミスを防止します

• Pretty-Formatプラグイン： Jestに多数の新しいpretty-formatプラグインを追加。Immutable.jsデータ構造とHtmlElementsをアサーション失敗時やスナップショットで見やすく表示

• カスタム環境： テストファイルのdoc-blockコメントに@jest-environment node|jsdomアノテーションを追加し、個別テストでデフォルトとは異なるテスト環境を使用可能に

以下は、すべての新APIが組み合わさってテスト体験をより楽しくする具体例です：

/**
 * @jest-environment node
 */

test('compares apples and bananas', async () => {
  expect.hasAssertions(); // Ensure this test has at least one assertion.

  await expect(
    Promise.resolve(Immutable.Map({apples: 1, bananas: 2})),
  ).resolves.toEqual(Immutable.Map({apples: 1, bananas: 3}));

  expect('banana'); // valid-expect in eslint-plugin-jest will show an error.
});

この例では、テスト失敗時に次のような出力が表示されます：

破壊的変更

メジャーリリースごとと同様に、将来の大規模な変更を可能にし、テスト体験を新たなレベルへ引き上げるため、いくつかの破壊的変更を行っています。今回私たちは、大多数のJestユーザーに影響しないAPIのみを変更するよう努めました：

• Jasmine 2.5のフォーク: Jasmine本体をフォークし、Jest独自のテストランナーの所有権を取得しました。これにより将来ユニットテスト体験のあらゆる側面を改善できますが、当面は段階的なリライトとAPIサーフェスの縮小に注力します。Jasmine APIが不足しているためにテストが失敗する場合は、jestまたはexpectオブジェクトで同等の機能が利用できるはずです。これに伴い、多くのコードベースで一般的に使用されていないJasmine機能を削除しました。

• CI環境での新規スナップショット: スナップショットは常にテストとテスト対象モジュールと共にコミットする必要があります。Jestを変更し、CI環境や--ciフラグ指定時には新しいスナップショットを自動保存しないようにしました（通常推奨されない）この動作を上書きするには--updateSnapshotフラグを使用できます。

• Babel-Polyfill: Jestは以前、babel-jest使用時に自動的にbabel-polyfillを読み込み、メモリリークを引き起こしていました。ほとんどのNode.jsバージョンではbabel-polyfillの読み込みは不要なため、この自動読み込みを削除し、代わりに非同期/待機構文をサポートするregenerator-runtimeのみをデフォルトで含めるように変更しました。babel-polyfillが必要な場合は、セットアップファイルで手動で読み込んでください。

その他の改善点

• ドキュメント: ベストプラクティスの共有と効果的なテスト手法の教育は、より良いソフトウェア開発に不可欠です。過去数週間でスナップショットテストFAQ、主要JSライブラリとの連携ガイド、前述の新機能に関するドキュメントを追加しました。

• 翻訳: Jestドキュメントの翻訳への協力を呼びかけています。より多くの方がJestを学びやすくなるようご協力ください。

• カスタムレポーター: reporters設定オプションを通じてカスタムテストレポーターをサポートしました。XML形式などでのレポート生成により、Jestの出力をカスタマイズしたり他のツールと統合したりできます。ドキュメント参照

• コードベースの健全性: Jestが迅速に進化できたのは、コードベースの健全性に多大な時間を費やしたからです。Prettierの早期導入、Flowカバレッジの大幅向上、Jasmineフォークによるテストランナーライブラリ改善、将来の成功に向けたJest本体の大規模リライトを実施しました。

• バグ修正: 常通り、Jestでは数多くのバグ修正を行いました。完全な変更履歴はJestリポジトリで確認できます。

Jestに関する講演

最近、JestコアチームとコントリビューターがカンファレンスでJestとその開発体験について講演を始めています：

• Rogelio GuzmanがReact ConfでJestスナップショットとその先について講演

• 私（cpojer）がFacebookのF8カンファレンスで高品質JavaScriptツールの構築について講演

今回も、JavaScriptコミュニティの皆様のご支援がなければ、このリリースを実現することはできませんでした。JavaScriptテストの改善に共に取り組める機会をいただき、心より感謝しております。Jestへの貢献をご検討の方は、どうぞお気軽にGitHubやDiscordでお声がけください。