Playwright × Cucumber（Gherkin 記法）で API インテグレーションテストを書いてみた

• URL: https://dev.classmethod.jp/articles/shoma-tried-writing-api-integration-tests-with-playwright-cucumber-gherkin/

• 日付: 2026-06-14

• Tier: Tier 2

• 要旨: Cucumber（BDD テストフレームワーク）と Playwright の request/expect を組み合わせて API インテグレーションテストを実装した実践記録。Gherkin 記法でテスト仕様書とテストコードが一体化する世界観を紹介。ブラウザバイナリインストール不要で HTTP クライアントとして利用可能。

詳細

• 構成: Cucumber（シナリオ実行）+ Playwright の request（HTTP クライアント）+ expect（アサーション）。axios + Jest を別々に入れる必要がなく1パッケージで完結。
• Gherkin: Given/When/Then で前提・操作・期待結果を記述。日本語も使用可能。
• テスト対象として Express API を src/server.ts に作成し、npm test で @cucumber/cucumber が Feature ファイルを実行。
• 動作環境: Node.js 24 / TypeScript 6.0.3 / @cucumber/cucumber 13.0.0 / @playwright/test 1.60.0 / express 5.2.1。