Skip to content

CodeceptJS docs

Now with AI-Powered Healing

CodeceptJS: Testing That Evolves

CodeceptJS combines scenario-driven testing, multi-backend support, and AI-powered self-healing to create tests that grow stronger with your application.

50K+
Active Users
1M+
Tests/Month
99.9%
Reliability

Test Dashboard

Success Rate 98.5%
Tests Passed 247
Avg Duration 2.3s
Login Flow 15/15
E-Commerce 23/23
API Tests 8/9
Powered by AI

Intelligent Testing
That Adapts & Learns

Revolutionary AI technology that makes your tests smarter, more resilient, and dramatically reduces maintenance overhead.

Self-Healing Tests

AI automatically fixes broken selectors when UI changes, reducing test maintenance by up to 80%.

↳ 80% less maintenance

AI Visual Testing

Computer vision algorithms detect visual regressions and UI inconsistencies automatically.

↳ Pixel-perfect accuracy

Smart Test Generation

AI generates comprehensive test scenarios including edge cases you might miss.

↳ 3x faster test creation

Predictive Analysis

Machine learning predicts potential test failures before they happen.

↳ 90% failure prevention

Intelligent Reporting

AI-powered insights and recommendations for improving test coverage and quality.

↳ Actionable insights

Natural Language Tests

Write tests in plain English and let AI convert them to executable code.

↳ Human-readable tests

Real-world Examples

See how CodeceptJS makes complex testing scenarios simple and readable

CodeceptJS Tests
const { faker } = require('@faker-js/faker'); // Use 3rd-party JS code
Feature('Store');
Scenario('Create a new store', async ({ I, login, SettingsPage }) => {
const storeName = faker.lorem.slug();
login('customer'); // Login customer from saved cookies
SettingsPage.open(); // Use Page objects
I.dontSee(storeName, '.settings'); // Assert text not present inside an element (located by CSS)
I.click('Add', '.settings'); // Click link by text inside element (located by CSS)
I.fillField('Store Name', storeName); // Fill fields by labels or placeholders
I.fillField('Email', faker.internet.email());
I.fillField('Telephone', faker.phone.phoneNumberFormat());
I.selectInDropdown('Status', 'Active'); // Use custom methods
I.retry(2).click('Create'); // Retry flaky step
I.waitInUrl('/settings/setup/stores'); // Explicit waiter
I.see(storeName, '.settings'); // Assert text present inside an element (located by CSS)
const storeId = await I.grabTextFrom('#store-id'); // Use await to get information from browser
I.say(`Created a store with ${storeId}`); // Print custom comments
}).tag('stores');`;
JavaScript UTF-8
Tests Passing

Human Readable

Tests read like plain English, making them easy to understand and maintain

Quick Setup

Get started in minutes with minimal configuration and setup

Real Scenarios

Test actual user workflows and business-critical functionality

Trusted by Developers

What Developers
Say About Us

Join thousands of developers who have transformed their testing workflow with CodeceptJS

"CodeceptJS has revolutionized our testing process. The AI-powered self-healing tests have reduced our maintenance overhead by 80%. It's simply incredible!"

SJ
Sarah Johnson
Senior QA Engineer at TechCorp

"The natural language syntax makes it so easy for our entire team to write and understand tests. Even non-technical stakeholders can read our test scenarios!"

MR
Michael Rodriguez
Lead Developer at StartupXYZ

"We switched from Selenium to CodeceptJS and saw immediate improvements. The multi-backend support means we can use the best tool for each scenario."

EC
Emily Chen
QA Manager at Enterprise Solutions

"The AI visual testing caught regressions that we would have missed manually. It's like having an extra pair of expert eyes on every test run."

DK
David Kim
Test Automation Lead at FinTech Pro

"CodeceptJS made our CI/CD pipeline so much more reliable. Tests that used to be flaky are now rock solid thanks to the intelligent retry mechanisms."

AL
Anna Lopez
DevOps Engineer at CloudScale

"The learning curve was incredibly gentle. Our junior developers were writing effective tests within days, not weeks. The documentation is fantastic!"

RT
Robert Taylor
Engineering Manager at WebFlow Inc
Test Management Platform

Supercharge with Testomat.io

Take your CodeceptJS testing to the next level with advanced test management, analytics, and team collaboration features.

Advanced Analytics

Get detailed insights into test performance, flaky tests, and execution trends with comprehensive dashboards.

Team Collaboration

Share test results, collaborate on test cases, and keep your entire team synchronized with real-time updates.

Test Management

Organize test cases, track requirements, and manage test execution with powerful filtering and search capabilities.

Test Dashboard

CodeceptJS Project

Live
98.5%
Success Rate
247
Total Tests
2.3s
Avg Duration
Recent Test Runs
Login Flow Tests
15/15 passed
E-commerce Checkout
23/23 passed
API Integration
8/9 passed

Get Started in 3 Steps

Integrate Testomat.io with your CodeceptJS project in minutes

1

Install Plugin

Add the Testomat.io plugin to your CodeceptJS configuration

npm install @testomatio/reporter
2

Configure API

Set your API key and project configuration

TESTOMATIO=your_api_key
3

Run Tests

Execute your tests and view results in the dashboard

npx codeceptjs run

Trusted by Industry Leaders

Join thousands of companies worldwide who trust CodeceptJS for their critical testing needs