🃏 Jest 19: 没入型ウォッチモードとテストプラットフォームの改善

非公式ベータ版翻訳

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

本日、Jestテストプラットフォームのバージョン19をリリースします。これまでで最大のJestリリースであり、過去2か月にわたって構築してきたものをお見せできることを大変嬉しく思います：

没入型ウォッチモード

ウォッチモードを完全に書き直し、即時性と拡張性を高めました。その結果、まさに没入型と呼べる体験が実現しました：ファイル変更後にテストが即座に再実行され、適切なテストを簡単に選択できるようになりました。

スナップショットの更新

スナップショット形式にいくつかの変更を加えました。このような変更は頻繁に行わず、実際にスナップショットの動作が改善される場合にのみ検討します。スナップショットのバージョン番号導入に加え、しばらく前から蓄積していたフォーマット改善をまとめて実装しました：

• トップレベルのtestやit呼び出しによるスナップショット名の「test」プレフィックスを削除

• React要素の出力を改善し、要素の最後のプロパティ変更時の差分を最小化

• 文字エスケープ機構を強化し信頼性向上

変更前：

exports[`test snap 1`] = `
<header>
  <h1>
    Jest \"19\"
  </h1>
  <Subtitle
    name="Painless JavaScript Testing" />
</header>
`;

変更後（「test」プレフィックスなし、JSXレンダリング改善、バージョンヘッダー）：

// Jest Snapshot v1, https://goo.gl/fbAQLP

exports[`snap 1`] = `
<header>
  <h1>
    Jest "19"
  </h1>
  <Subtitle
    name="Painless JavaScript Testing"
  />
</header>
`;

すべての開発者が互換性のあるJestバージョンを使用できるよう、バージョン管理されたスナップショットを導入する適切なタイミングと判断しました。スナップショット更新が必要な場合の警告は次のようになります：

移行をスムーズに行い、失敗したテストからの不要な変更が新しいスナップショットに含まれないよう、更新前には必ずローカルの変更を元に戻してください。

スキップテストの出力改善

詳細モードや単一スイートテスト時、スキップされたテストは個別に表示せず1行に集約されます。これにより重要なテストに集中できるほか、表示スペースも大幅に削減されます！

新CLI引数

Jest 19ではCLIから実行可能な2つの新しいカバレッジ関連引数を追加：

• --collectCoverageFrom

• --coverageDirectory

無効なCLI引数は無視せずエラーを発生させるよう変更しましたが、親切なエラーメッセージでサポートします（例：jest --watc実行時）：

expectの改善

• expect.addSnapshotSerializer

• expect.stringContaining

• jest.spyOn

expect npmパッケージとのほぼ完全な機能互換性を達成しました。パッケージ作者のMichael JacksonがJestプロジェクトへの寄付に同意したため、jest-matchersはexpectに名称変更されます。当方のexpectは完全互換を意図していないため、Christopher Chedeauがシームレスな移行のためのコードモッドを開発中です。Christopherはまた、jest-matchersのJest外での利用を可能にする改良を実施し、ブラウザ内での動作も実現しました。

eslint-plugin-jest – 公式ESLintプラグインの登場

Jonathan Kim氏の貢献により、Jestがついに公式ESLintプラグインを提供できるようになりました。このプラグインは以下の3つのルールを実装しています：

• no-disabled-tests - 無効化されたテストの誤ったコミットを防止

• no-focused-tests - テストスイート内の他テストを無効化するfocusedテストのコミット防止

• no-identical-title - 重複するテストタイトルの禁止

npm install --save-dev eslint-plugin-jest または yarn add --dev eslint eslint-plugin-jest でインストール可能です。ESLint設定に {"plugins": ["jest"]} を追加することで有効化できます。

新パッケージ公開: jest-validate

Jest設定の検証・正規化コードをリファクタリングする過程で、新しいエラーメッセージングの仕組みが非常に有用だったため、独立したモジュールとして抽出しました。Jest 19では新たに jest-validate が公式パッケージファミリーに加わります。

jest-validate はJavaScriptツール向けの汎用設定検証ツールで、警告・エラー・非推奨メッセージを管理します。ユーザーフレンドリーな設定例の表示機能や、シンプルかつ強力なAPIを備えています。皆さんのプロジェクトにも役立つはずです！

jest-validate は prettier の設定オプション検証に v0.12 から採用されています。ぜひプロジェクトに追加して試してみてください。フィードバックやGitHubでのプルリクエストをお待ちしています。

非対称マッチャーの強化

非対称マッチャーの実装をJasmineからJest本体へ移行し、ユーザーエクスペリエンスを大幅に改善しました。これによりマッチャーの整形表示が最適化され、新たに expect.stringContaining() マッチャーが追加されました。さらに expect.toMatchObject() との連携も強化され、両機能を組み合わせて活用できるようになりました：

手動モックの機能強化

ネストしたフォルダー構造での手動モックが正式にサポートされました。例: __mocks__/react-native/Libraries/Text/Text.js が期待通りに動作します。仮想モックと推移的依存関係の問題を修正し、複数パターンが同一ファイルにマッピングされる場合の moduleNameMapper の動作も改善されました。

破壊的変更

公式サポート外だった mocksPattern 設定オプションを削除しました。また testPathDirs オプションは機能をより明確に表現するため roots に名称変更。roots のデフォルト値は ["<rootDir>"] で、任意の数のディレクトリを指定可能です。rootDir オプションは従来通り他の設定のプレースホルダーとして機能し、この変更により設定がより直感的になります。

ドキュメントの刷新

Hector Ramos 氏と Kevin Lacker 氏によるJestドキュメントの刷新が完了しました。サイト構成を変更し、ドキュメントとAPIを独立したページとして提供するようになりました：

• ドキュメントでは、Jestの導入ガイドが用意されています。Getting Startedや非同期コードのテストに加え、便利なガイドとしてスナップショットテスト、React Nativeアプリのテスト、webpackとの連携、Jestへの移行などが掲載されています！

• 一方APIセクションでは、Jestが提供する全メソッドを網羅しています：expectオブジェクトやjestオブジェクト、モック関数、グローバル変数に加え、_package.json_やCLIからの設定オプションも確認できます。

ホームページは「ゼロ設定のテストプラットフォーム」というJestの特徴をより明確に伝えるために全面的にリデザインされました。モバイルデバイスでの読みやすさも向上しています。RSSユーザーの皆様には、待望のブログフィードも提供開始しました。

コミュニティアップデート

• Vas Boroviak氏による「Jest入門」講演は本当に素晴らしい内容でした。

• Twitterの@jestjs_をフォローしましょう。

• Jestコアチームは週1回の定例ミーティングで現在の課題や将来計画を話し合っています。Jestへの貢献に興味があれば、プルリクエストを送った上で週次ミーティングへぜひご参加ください。

• Artsyの優秀なエンジニア陣が2017年フロントエンドスタックの一環としてJestを紹介しています。

• Stephen Scott氏はReactコンポーネントのテスト手法について詳細な記事を執筆し、各アプローチの長所短所を比較しています。

• Cristian Carlesso氏のブログ記事でVue.jsとJestの連携方法が大幅に簡素化されました。

• Michele Bertoli氏のReactデザインパターンとベストプラクティスに関する書籍では、Jestに関する章がまるごと設けられています。

• OS通知を表示する--notifyコマンドが強化され、通知から直接テストを再実行できるようになりました。実はこれもJestの新機能です（このブログ記事を最後まで読んでいるかどうかの確認テストも兼ねています）。

• Jestがreact-boilerplateに正式採用されました。

• Jestマッチャーの隠れた機能についての記事も公開されています。

最後に嬉しいお知らせとして、avaテストランナーがJestプラットフォームの一部を採用し、基本的なスナップショットサポートとpretty-formatを実装しました。テストインフラの統合によりアプリケーションテストの学習コストが低下し、ベストプラクティスの共有が促進されます。既存テストライブラリから今後も学べることを楽しみにしています。

完全な変更履歴はGitHubでご覧いただけます。Jest 19は17名の皆様が貢献した真のJavaScriptコミュニティの協力の成果です。プロジェクトをより良くするためにご協力いただいた皆様一人ひとりに感謝します。

このブログ記事は Rogelio Guzman と Michał Pierzchała が執筆しました。