# codeceptjs/CodeceptJS

Supercharged End 2 End Testing Framework for NodeJS

Repository: https://github.com/codeceptjs/CodeceptJS
Canonical: https://ross.abutalabs.com/products/codeceptjs
Homepage: http://codecept.io
Language: JavaScript
License: MIT
License Family: permissive
Topics: codeceptjs, webdriverio, selenium-webdriver, acceptance-testing, end-to-end-testing, nodejs, pageobject, graphql-testing, e2e-tests, playwright, hacktoberfest, bdd, bdd-framework, javascript, selenium, testing, webdriver
Last push: 2026-08-24T12:24:15+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 95, longevity 100
- inputs: {"age_days": 3938, "days_push": 9, "days_rel": 34, "gap_med": 8, "n_releases_24m": 22}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4241, forks 757 (observed 2026-08-28T04:08:39.636316+00:00)

## What it is
CodeceptJS is a Node.js end-to-end testing framework with a BDD-style syntax where tests are written as user-perspective scenarios using an 'I' actor API. It delegates commands to interchangeable backends including Playwright, WebDriver, Puppeteer, and Appium for web and mobile testing.

## Use cases
- write end-to-end tests for a web app
- run acceptance tests with Playwright or Selenium
- test mobile apps with Appium
- migrate from Cypress or Protractor
- write BDD-style browser tests in JavaScript
- automate browser testing across Chromium, Firefox, and WebKit
- let AI agents write and run browser tests

## When to choose
- you want readable, scenario-style E2E tests that abstract away selectors
- you need one test API that works across Playwright, WebDriver, Puppeteer, and Appium
- your team prefers BDD-style acceptance testing in JavaScript or TypeScript
- you want AI/agent-friendly tests with an MCP server

## When to avoid
- you need unit or component-level testing rather than browser E2E
- you are heavily invested in another E2E tool's ecosystem like Cypress
- you need non-JavaScript test code
- you require fine-grained low-level control of browser internals

## Facets
- artifact type: framework
- maturity: active
- function: e2e-testing, testing, web-scraping
- domain: testing, web-development, developer-tools
- platform: cross-platform
- tags: bdd, acceptance-testing, playwright, webdriver, puppeteer, appium, page-object, browser-automation, mcp-server, nodejs, javascript

## Member repositories
- codeceptjs/CodeceptJS (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:39.636316+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:14.943673+00:00, confidence not recorded.
  - readme: https://github.com/codeceptjs/CodeceptJS (fetched 2026-08-28T04:08:39.636316+00:00, sha 8832525838da)
  - homepage: http://codecept.io (fetched 2026-08-29T09:12:20.443759+00:00, sha def8e0a60e10)
  - site_page: https://codecept.io/quickstart (fetched 2026-08-29T09:12:20.446487+00:00, sha 7eacf9559cb6)
  - site_page: https://codecept.io/release (fetched 2026-08-29T09:12:20.448876+00:00, sha ee683de0c8f0)
  - site_page: https://codecept.io/basics (fetched 2026-08-29T09:12:20.451163+00:00, sha dde66d0c0fe6)
- Data as of 2026-08-30T08:39:29.467469+00:00.
