概要
CodeceptJSは、Playwright、WebDriver、Puppeteer、Appium等のbrowser/mobile automationを共通の`I`ステップへ抽象化するE2E test frameworkです。BDD風のScenarioで操作とassertionを直線的に記述できます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
利用者視点の`I`ステップでE2E scenarioを書く
I.amOnPage、I.click、I.see等の高水準stepで、画面操作とassertionを読みやすいscenarioとして表現できます。
出典:[2]
Playwright・WebDriver・Appium等をHelperとして選ぶ
Webやmobileの実行engineをHelperとして切り替え、同じtest styleのまま対象platformへ合わせられます。
E2E testの記法をteamで共通化したい場合に
browser automation APIの詳細をtest scenarioから隠し、page objectやstep objectを含む共通test設計を作りたいteamに向きます。
出典:[2]
4.xは開発系列なのでHelper互換性とNode要件を確認する
default branchのpackageは4.0.0-rc.1でNode.js 22.12+です。Playwright/WebDriver等のversion互換性を含め、release lineを固定して導入してください。
参考にした公式資料
- [1]codeceptjs/CodeceptJS repository(2026-09-21)
- [2]CodeceptJS README(2026-09-21)
- [3]CodeceptJS documentation(2026-09-21)
- [4]CodeceptJS package(2026-09-21)
- [5]CodeceptJS MIT license(2026-09-21)
編集部からの補足
現在のdefault branchは4.xで、packageは4.0.0-rc.1、Node.js 22.12.0以上を要求します。READMEは4.2要件にも言及しており、4.xは移行中の開発系列です。Playwright等の実行engineをHelperとして差し替える設計なので、採用するHelperとbrowser依存を先に固定してください。
3ステップで試す
- 1
CodeceptJSを追加して初期化
4.x READMEの手順でpackageを追加し、利用するHelperを選んでtest環境を生成します。
npm i codeceptjs --save && npx codeceptjs init - 2
最初のtestを生成
BDD風Scenarioを書き始めるためのtest fileをCLIから作成します。
npx codeceptjs generate:test - 3
step表示付きで実行
利用者視点のI stepを表示しながらE2E testを実行します。
npx codeceptjs run --steps
成長
成長の推移 · 直近30日
4,240 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 30
- Open PR
- 24
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Playwright96,435 Stars
共通タグ 3件 · 共通カテゴリ 2件
Chromium・Firefox・WebKitのE2Eテスト、script、CLI、MCPを一つのAPIで扱うWeb自動化基盤。
TypeScript - Storybook91,112 Stars
共通タグ 1件 · 共通カテゴリ 2件
UIの状態をstoryとして保存し、開発・レビュー・ドキュメント・テストへ再利用するコンポーネント開発ツール。
TypeScript - Jest45,462 Stars
共通タグ 1件 · 共通カテゴリ 2件
expect、watch mode、snapshot testingをまとめ、多くのJavaScriptプロジェクトですぐ使えるテスト基盤。
TypeScript - Vitest17,135 Stars
共通タグ 1件 · 共通カテゴリ 2件
Viteのconfig・transformer・pluginを共有し、TypeScript/ESMをそのまま扱える高速なJavaScript/TypeScript test framework。
TypeScript - JUnit7,055 Stars
共通タグ 1件 · 共通カテゴリ 2件
Java/JVM向けのtest frameworkで、test実行基盤のPlatform、新規test API/engineのJupiter、旧JUnit 3/4互換用Vintageから構成される。
Java
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。