ゴールデンファイルとは？

ゴールデンファイルは、ある操作の期待出力をチェックインしたコピーで、テストは新たに生成された出力とこれを比較し、不一致があれば失敗します。生成されたコード、レンダリングされたHTML、シリアライズされたデータなど、フィールドごとにアサーションを書くのが面倒な、複雑または大きな出力を捉えます。ゴールデンファイルは、変更が意図されたときに意図的に更新されます。

なぜ重要か

手でアサーションを書くには大きすぎる出力に対して、ゴールデンファイルは挙動を固定し、意図しない変更を捉える実用的な方法です。必要な規律は、ゴールデンを更新する際にdiffをレビューすることです。何も考えずに再生成すると、コードが今生成するものをそのまま受け入れてしまい、目的を台無しにするからです。

関連する概念

• ゴールデンマスターや承認テストとも呼ばれる
• snapshotテストと密接に関連する
• 更新には盲目的な再生成ではなくdiffのレビューが必要

関連ガイド