Jest 24: 💅 刷新され、洗練され、TypeScriptに優しい

非公式ベータ版翻訳

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

本日、Jestの新メジャーリリースとなるバージョン24を発表できることを嬉しく思います！前回のマイナーリリースから4ヶ月、Jest 23からは8ヶ月ぶりのアップグレードとなるため、全てのユーザーにとって重要なアップデートです！主なハイライトは、Jest内部をBabel 7にアップグレードしたことによるTypeScriptの組み込みサポート、コンソール出力が欠落する長年の問題の修正、大規模な差分計算時のパフォーマンス問題の解決、そして真新しいウェブサイトの公開です。✨

全ての変更点については変更履歴をご覧ください。

新しいウェブサイト

@ortaによるJestウェブサイトの美しいリデザインが、コミュニティメンバーの@montogeekと@brainkimによって実装されました。

リデザインの目的は、Jestの素晴らしい特徴をより際立たせるとともに、Jestが主にReactアプリのテストツールであるという認識を切り離すことです。Jestはあらゆる種類のプロジェクトで使用でき、そのことを明確に示したいと考えています。リデザインの背景にある考え方はこちらのIssueで詳しく読めます。

TypeScriptサポート

Jest 24では内部をBabel 7にアップグレードし、TypeScriptプロジェクトのサポートを実現しました。これは@babel/preset-typescriptを使用するようBabelを設定すれば、JestがTypeScriptのトランスパイルをすぐにサポートできることを意味します。Flowと同様、デフォルトのTypeScriptサポートにおける注意点として、Babelは型アノテーションを取り除いてコードを有効なJavaScriptにするだけで、コードの型チェックは行いません。

Jestは2017年12月リリースのバージョン22以降Babel 7をサポートしていましたが、Babel 6のサポートとの互換性を保つためブリッジモジュールの使用が必要でした。Jest 24ではコミュニティメンバーの@milesjの多大な協力を得て完全にBabel 7へ移行しました。これにより設定が容易になり、設定ファイルの読み込みや自動的なmodulesトランスパイルなど、Babel 7の機能を活用できるようになりました。babel-core@^7.0.0-bridge.0は不要になったため削除してください。

テスト実行時に型チェックを行いたい場合はts-jestを使用してください。Jestはデフォルトで.ts（および.tsx）ファイルにBabelを適用するため、トランスフォーマーの設定が必要です。別の方法として、tscを実行するか、Jestランナーを使用してテスト実行と同時にTypeScriptをトランスパイルすることも可能です！詳細はjest-runner-tscをご覧ください。

詳細はドキュメントを参照してください。

ヒント

何らかの理由でBabel 7にアップグレードできない場合でも、babel-jestをバージョン23に維持すれば、Jest 24をbabel@6と併用できます。

test.todo

Jest 23では、実装が欠落しているテストがスキップされる代わりにエラーを投げるように変更されました。この変更は、誤ってスキップされたテストの発見や追跡が困難だというフィードバックに基づくものでした。しかし、この変更により、どのテストを書くか下書きするためにこの機能を使用していた多くの開発者のワークフローが壊れてしまいました。

Jest 24では、優れたAVAにインスパイアされた明示的なtest.todoを追加することでこの問題に対処します。これはテストサマリーに個別に表示され、書きたいテストを素早く下書きできます。将来的にはESLintルールによって、いくつかのテストを書き忘れていることを警告できるようになるかもしれません。

test.todo('invalid input should throw');

test.todo('missing options should be normalized');

改良されたアサーションメッセージ

テストが失敗した際、期待される進捗と予期せぬ退行を確信を持って正しく判断する必要があります。特に、多くの進捗の中に隠れた少数の退行を見逃さないことが重要です。Jest 24では複数のマッチャーでアサーション失敗時のレポートがより明確かつ簡潔になりました。この改善はJest 25でも継続されるため、一時的な不整合に気付く場合があります。テストが決して失敗しない方には見えませんが、それ以外の方々は期待通りに動作しない理由をより簡単にデバッグできるようになるでしょう。コミュニティの貢献者である@ittordepamや他の方々の尽力に感謝します。

これらの変更は以下のPRで確認できます: 7621, 7557, 7448, 7325, 7241, 7152, 7125, 7107, 6961。

例:

失敗したアサーション

型不一致

モック関数が呼び出されない

長年の課題の解決

このリリースではいくつかの古くからの課題を修正しました。

最初に注目したいのはconsole.log出力が消える問題です。Jestはログをインターセプトして収集し、スタックトレースを提供したりレポーターに渡したりしますが、特定のエッジケースで出力が完全に消える問題がありました。幸いJest 24では@spionがこの問題を解決してくれました。多大なる貢献に感謝します！

二つ目は、期待値と実際の値のシリアライズ差分が大量の挿入変更を含む場合（テストの誤りやシリアライザの欠陥による予期せぬ変更、またはテスト駆動開発中の一時的な失敗による期待される変更）にJestがメモリ不足になる問題です。@ittordepamが以前の差分アルゴリズムをdiff-sequencesパッケージに置き換え、理論上最小限のメモリ使用量でこの問題を解決しました。これにより将来的にgitが提供するような単語単位の差分実装が可能になります。このPRを参照し、実装に協力したい方はぜひご連絡ください！

その他の注目点

• globalSetupとglobalTeardownの改善：setupFilesと同様にコード変換が適用されるようになり、projectsの一部としてもサポートされました。

• Jestのスナップショット保存場所を設定可能に：大規模なビルドプロセスでJestを使用するツール構築に特に有用です。

• JestのCLIにはこれまで、一部のフラグやオプションがキャメルケース（例: runInBand）なのに対し、他のものはそうでない（例: no-cache）という特徴がありました。Jest 24では両方が認識されるようになったため、CLI引数を自由な形式で記述できるようになりました。

• setupTestFrameworkScriptFileをsetupFilesAfterEnvに名称変更し、配列形式にしました。このオプションの目的がより明確になることを期待しています。次期メジャーバージョンでは設定のさらなる見直しを計画しています（詳細は下記セクション参照）。

• Jestが「とにかく動作させる™」ために行ってきたマジックを減らすため、今回のリリースではコンパイルされた非同期コードで使用されることがあるregenerator-runtimeの自動注入を廃止しました。regenerator-runtimeは常に必要ではなく、必要な場合はユーザーが責任を持って含めるべきだと考えています。@babel/preset-envをtargets設定（例: Node 6+）で使用する場合、これを含める必要はありません。詳細はUsing Babelのドキュメントをご覧ください。

• Node.js 10にはブラウザのWorkerスレッドと類似した実験的モジュールworker_threadsが導入されました。Jestプラットフォームの一部であるjest-workerは、child_processの代わりに利用可能な場合worker_threadsを使用できるようになり、さらなる高速化を実現！ベンチマークでは50%の改善が確認されています。実験的な性質のため、Jestをテストランナーとして使用する際はデフォルトで有効になりませんが、自身のプロジェクトで今すぐ使用可能です！Node.jsで実験的ステータスから昇格した際にはデフォルトで有効化する予定です。

破壊的変更

すべての破壊的変更は変更履歴に記載されていますが、特に注目すべき点をいくつか紹介します：

• Micromatch 3へアップグレードしました。すべてのユーザーに影響するわけではありませんが、Jest 23で使用されていたバージョン2よりもglobの解析が厳密になっています。問題が発生した場合はこちらおよび関連イシューで無効なglobの例を確認してください。

• Node 4用のコード残骸を削除しました。以前は技術的にJest 23をNode 4で実行可能でしたが、今後はポリフィルやトランスパイルなしでは不可能です。

• スナップショット内のモック関数のシリアライズ方法に変更があります。アップグレード後は更新されたスナップショットを必ず再確認してください。関連PR。

• Jestはregenerator-runtimeを自動注入しなくなりました。関連するエラーが発生した場合は、@babel/preset-envなどを使用してasync関数を適切にトランスパイルするようBabelを設定してください。関連PR。

今後について

State Of JS 2018でJestが「最高満足度」賞を受賞した結果に深く感銘を受けています。2018年のもう一つの大きな出来事は、10月にJestの週間ダウンロード数が初めて200万を突破したことです。皆様に感謝申し上げます。

コミュニティから示された信頼に心から感謝するとともに、今後もこの信頼を築き上げていきたいと考えています。Jest 24および将来のリリースでは、この素晴らしい基盤をさらに発展させ、JavaScript開発者のツールキットに不可欠な存在であり続けることを約束します。

今回のリリースでは、Open Collectiveの資金を活用したバグ報奨金制度を初めて導入しました。この取り組みは、非コア開発者の方々が新しいランディングページ実装に参加するきっかけとして効果的でした。特に、Jestのグローバル変数とNodeのグローバル変数が一致しないという長年懸案だった問題解決に向けて前進しています。今後もこの制度を拡充したいと考えていますので、報奨金対象として適した未解決バグをお持ちの方はぜひお知らせください。現在報奨金が設定されているチケットはissueラベルから確認できます。

すでにJest 25のリリース計画も進行中です。最大の目玉機能は設定システムの刷新で、オプションの重複やグロブ/正規表現の混在などにより現行の設定が複雑化している課題を解決します。Jestの設定体系についてのご意見をこちらのissueで大募集しています。

コードベースをFlowからTypeScriptへ移行する計画についてもご存知かもしれません。この移行により、より多くのコントリビューターが参加しやすくなり、2019年のJavaScriptテスト環境がさらに進化することを期待しています。🚀 この変更は近い将来のマイナーリリースで実装予定です。移行に関するご意見はRFCへお寄せください。

最後に、Jestの内部構造に興味のある方へ。@cpojerがJestのアーキテクチャ概要を解説する動画を公開しました。さらに詳しく知りたい方はお気軽にお問い合わせください。動画は当サイトのアーキテクチャ解説ページでご覧いただけます。

楽しいテストを！ 🃏