Jest 23: 🔥 超高速で楽しいテスト体験

非公式ベータ版翻訳

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

本日、Jest史上最大のメジャーリリースとなるJest 23の公開を発表できることを大変嬉しく思います！100名以上のコントリビューターと共に、数多くの新機能とバグ修正を提供しました。JavaScriptテストを楽しいものにするために協力してくださったコミュニティの皆様に感謝します。

また、BabelとwebpackをJestコミュニティへ歓迎いたします！MochaからJest 23 Betaに移行したwebpackは、テストスイート全体の実行時間を13分以上から2分20秒へ6倍も短縮することに成功しました。#blazingmeansgood

以下にJest 23の主なハイライトと破壊的変更を紹介します。

全リストは変更履歴をご覧ください。

インタラクティブスナップショットモード

新たにデフォルトのウォッチメニューオプションとして「インタラクティブスナップショットモード」を追加しました。このモードでは、失敗したスイートごとに各失敗スナップショットをステップ実行し、失敗したスナップショットを確認しながら個別に更新するかスキップするかを選択できます。

インタラクティブスナップショットモードの詳細はこちらをご参照ください。

スナップショットプロパティマッチャー

スナップショット対象のオブジェクトには、日付やIDなどの生成値が含まれることがよくあります。Jestでは今後、スナップショットマッチャーに特定の値ではなくデータ構造を指定するプロパティを渡せるようになりました。これらのプロパティマッチャーはシリアライズ前に検証され（値の代わりにマッチャータイプが記録される）、テスト実行間で一貫性のあるスナップショット結果が得られます。

詳細は更新されたtoMatchSnapshotドキュメントまたはプロパティマッチャーガイドをご覧ください。

カスタム非同期マッチャー

expect.extendsで非同期マッチャーをサポートしました！非同期マッチャーはPromiseを返すため、マッチャーの解決をawaitで待機できます。使用例：

ドキュメントはこちらから。

カスタム非対称マッチャー

非対称マッチャーは、非対称的な等価性のみを考慮したい場合に最適なツールです。例えば左辺が右辺のプロパティの部分集合を持つオブジェクトと期待され、完全一致ではない場合などです。Jestは標準で多くの非対称マッチャーを提供しており、今回カスタム非対称マッチャーを新たに導入します。

Jest Each

@mattphillipsio氏がjest-eachパッケージをJestコアに寄贈してくださいました（Mattさん、ありがとうございます！）。jest-eachはmocha-eachとSpockデータテーブルに触発されたライブラリで、テストケースのテーブルを定義し、指定された列値を使用して各行ごとにテストを実行できます。すべてのdescribeとtestのバリエーションで、配列型とテンプレートリテラルの両方をサポートします。ドキュメントはこちらで、Jest 23未使用の方のためにjest-eachは個別に公開し続けます！

Prettierがテーブルフォーマットの修正を迅速に行ってくれたことに心から感謝します（Prettier 1.13参照）！

新しいマッチャー

コアにマッチャーを追加するのは、Jestコミュニティの大多数にとって有用だと確信した場合のみであり、ほとんどのマッチャーはコミュニティに委ねています（jest-extended参照）。しかし一部のマッチャーはコアに採用され、Jest 23で以下が追加されました：

• nthCalledWith

• toReturn

• toReturnTimes

• toReturnWith

• lastReturnedWith

• nthReturnedWith

• toStrictEqual

更新されたexpectドキュメントはこちらからご覧ください。

ハングするテストのデバッグ

Issueトラッカーでよく見かける問題として、テスト実行後に「Jestがハングする」という報告があります。これは通常、アプリケーションコードがハンドルを開放せず、Jestの終了を妨げていることが原因です。これまでは--forceExitで対応していました（非推奨）。

これらの問題をデバッグしやすくするため、Jestが終了しない場合を検出するようになりました：

さらに、オープン状態のハンドルを見つけるための新フラグ--detectOpenHandlesを提供します：

更新されたCLIドキュメントはこちらをご覧ください。

ウォッチモードプラグイン

ウォッチモードシステムを完全に書き直し、カスタムプラグインの追加を可能にしました。ウォッチモードプラグインにより、Jestイベントにフックしたり、ウォッチモードメニューにカスタムオプションを追加できるようになりました。標準のウォッチモードプロンプトはすべてこのシステムのプラグインとして実装されており、自作方法はこちらで公開しています。

この変更により、jest-watch-typeaheadを通じてタイプアヘッドサポートもウォッチモードプラグインとして復活しました！

ドキュメントとインストール方法はjest-watch-typeaheadをご覧ください。新しいウォッチモードプラグインシステムとjest-watch-typeaheadプラグインを提供してくれた@rogeliogに心から感謝します！

破壊的変更

他のメジャーリリースと同様、将来の大規模な変更を可能にし、テスト体験を新次元へ引き上げるため、いくつかの破壊的変更を加えました。主な変更点は以下の通りです：

• テストの説明文と関数の必須化: 関数と説明文の両方を含まないテストは失敗するようになりました。

• Reactスナップショットからのundefinedプロパティ削除: スナップショットの小型化とReactの適切な動作を実現。

• 非推奨機能の削除: mapCoverageは不要になったため削除。さらにjest.genMockFunctionとjest.genMockFnはjest.fnと同等のため削除。

• スナップショット失敗時の名前表示: 失敗メッセージにスナップショット名（指定されている場合）を追加し、失敗したスナップショットの特定を容易にしました。

• モックタイムスタンプの置換: 複数のモックが同じタイムスタンプを持つ可能性があるため、呼び出し順序のテストが不可能だった問題を解決するため、invocationCallOrderでタイムスタンプを置換しました。

• モックスナップショットへの結果追加: モック関数の呼び出し結果をスナップショットに追加し、呼び出しと実行結果の両方を追跡できるようにしました。

その他の改善点

• ウォッチモードのカバレッジ: --onlyChangedや--findRelatedTests使用時およびウォッチモードでは、テスト対象ファイルのみのカバレッジ計測に限定されました。

• バージョン別ドキュメント: Jest 22以降の各マイナーバージョンごとのドキュメントを追加し、ドキュメントから「Jest X.X+が必要」という記述をすべて削除しました。

• スナップショットサマリーの改善: 廃止予定のスナップショットに関する情報をより分かりやすくするため、サマリー出力を全面刷新しました。

• スタックトレースの改善: 非同期エラー、タイムアウトエラー、expect.assertions、エラー以外のスロー対象についてスタックトレースを追加。コードフレームのカラム表示も実装しました！

• React 16サポートの強化: React.Fragment、React.forwardRef、React.createContextのスナップショットサポートを追加。

• モックの戻り値・スロー値の追跡: 各モック呼び出しの戻り値またはスローされた値を含むmock.resultsを追加。

• Blazing 🔥: Jestが「超高速」であることを示すblazingバッジをREADMEに追加しました。

Jestサミット

先週、JestコアチームはFacebookロンドンでJestサミットを開催。Jest 23のリリース作業を行い、Jestオープンコレクティブを発表するとともに、以下の講演を行いました：

• Christoph Nakazawa – イントロ

• Aaron Abramov – 意味のあるテストを書く

• Rick Hanlon II – Jest 23における超高速スナップショットテスト

• Simen Bekkhus – Jestの素晴らしいエラーメッセージ

• Matt Phillips – コミュニティパッケージでJest体験をレベルアップ

• Michele Bertoli – あらゆるものをスナップショット化

• Jordan Eldredge – Webamp：模倣を通じて学ぶ

全講演はこちらでご覧いただけます。

多数のご参加をいただき、ロンドンを拠点とするコミュニティメンバーと直接交流する機会を得ました。ご参加・継続的なサポートに心より感謝申し上げます！次回の投稿では、Jestオープンコレクティブと今後の計画について詳しくご紹介します。

今回のリリースも、JavaScriptコミュニティの皆様のご協力なしには実現できませんでした。JavaScriptテストの改善に共に取り組める機会に深く感謝しています。Jestへの貢献をご希望の方は、遠慮なくGitHubまたはDiscordまでお問い合わせください。