Gherkin記法

## なぜ Gherkin なのか テスト仕様書を開発者がコードで、ビジネス側が日本語や英語のドキュメントで、それぞれ別々に管理する現場は多い。仕様変更のたびに両方を更新する必要があり、ズレが蓄積する。Gherkin記法はこの問題を「実行可能な仕様書」というアプローチで解決する。

ビジネス担当者が読める自然言語に近い構文でありながら、そのまま自動テストとして実行できる。仕様書とテストコードが同一ファイルに収まるため、乖離が構造的に起きにくい。## 基本構文 `.feature` ファイルの典型的な構造は以下のとおり。

```gherkin Feature: ユーザーログイン Scenario: 正しい認証情報でログインできる Given ログインページを表示している When メールアドレス "user@example.com" を入力する And パスワード "correct-password" を入力する And ログインボタンをクリックする Then ダッシュボードが表示される ``` `Feature` が機能単位のまとまり、`Scenario` が個別のテストケースに対応する。`And` / `But` で条件を追加でき、`Scenario Outline` + `Examples` テーブルでパラメータ化も可能。日本語を含む 70 以上の自然言語に対応しており、キーワードをそのままローカライズできる点も特徴の一つ。

## BDD との関係 Gherkin記法は BDD（振る舞い駆動開発）のプラクティスから生まれた。BDD では「ソフトウェアが何をすべきか」を利害関係者全員が共有できる形で記述することを重視する。Gherkin はその記述フォーマットを標準化したもので、Cucumber・Behave・SpecFlow といったフレームワークが Gherkin ファイルをパースしてテストを実行する。

筆者のチームでは受け入れテストを Gherkin で書き始めてから、QA と開発者のレビュー会議で「この Scenario が通ればリリース可」という合意形成が格段に速くなった。## 導入時の落とし穴 万能ではない。ステップ定義（Given/When/Then の裏側で実行される実装コード）の粒度設計を誤ると、似たようなステップが大量に増殖して保守コストが跳ね上がる。

また、UI の細かい操作を Gherkin で逐一書くと冗長になりがちで、E2Eテストのすべてを Gherkin 化するより、ビジネスルールの検証に絞って適用するほうが費用対効果は高い場合が多い。