JavaScript Cypress package: @testersai/cypress

Cypress × Testers.AI

The easiest way to AI-upgrade your existing Cypress suite. You already have the tests — this adds AI Checks at the moments that matter, without replacing your framework, runner, or CI pipeline.

Download SDK Docs Jira / Xray / TestRail / Cypress Cloud

Add these AI testers to your existing tests

21 named specialists — pick by first name in any analyze_* call, or define your own.

See all + custom testers →

Install

# Download testersai-javascript-cypress-0.1.0.tar.gz from the Downloads page, then:
tar -xzf testersai-javascript-cypress-0.1.0.tar.gz
cd testersai-javascript-cypress-0.1.0
npm install ./testersai-sdk-0.1.0.tgz ./testersai-cypress-0.1.0.tgz

Example

A complete, runnable JavaScript / TypeScript + Cypress example.

// cypress.config.js
const { registerTasks } = require('@testersai/cypress');
module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, cfg) { registerTasks(on, cfg); return cfg; }
  }
});

// cypress/support/e2e.js
require('@testersai/cypress/commands');

// spec:
it('home page', () => {
  cy.visit('https://example.com');
  cy.testersaiScreenshot();
  cy.testersaiPageText();
});

How it flows

🧪

Your test runs

Cypress — unchanged.

📸

SDK captures

Screenshot, console, network, or page text.

🤖

Testers.AI analyses

Returns AI-identified issues.

📝

Cypress report

Findings shown where you already look.

🔗

Optional: auto-log

Jira · Xray · TestRail · Cypress Cloud.

Cypress command log + Cypress Cloud (when CYPRESS_RECORD_KEY is set). If the AI call fails — rate limit, hang, firewall, no network — the SDK gives up fast and returns a skipped result. Your Cypress test is never blocked.

Where & when to put checks

Rule of thumb: wherever a human reviewer would pause to look during a manual run. These recommendations are tuned for Cypress — pick the ones that fit your suite.

After every meaningful navigation

The page just re-rendered. Ask "does this look right?" before any interaction.

after page.goto() / driver.get()

After a state-changing action

after click / fill

Right before your main assertion

You were about to check one thing. Ask the AI about everything else for free.

before expect(...)

After async operations settle

API returned, spinner gone, toast shown. Catch broken empty-states and stale data.

after wait_for_selector

In teardown / afterEach

A single console + network check at the end of every test catches issues your assertions ignored.

afterEach / teardown

On responsive / theme switch

Mobile vs. desktop, light vs. dark, locale change. One call per viewport.

after setViewport

In `afterEach`

Hook cy.testersaiConsole() in a global afterEach. Catches errors your spec never looked at. Zero per-spec code.

global afterEach

Value: what you get for three extra lines

✓
Free upgrade to your existing Cypress code.
No rewrites, no new dashboard, no new runner — reuse every selector, fixture, and helper you already built.
✓
Findings land in the Cypress report.
Cypress command log + Cypress Cloud (when CYPRESS_RECORD_KEY is set).
✓
Optional TMS integration.
Set a few env vars and qualifying findings auto-log to Jira / Xray / TestRail / Cypress Cloud. Broken TMS never fails your test.
✓
Never blocks the suite.
Capped retries, hard deadline, graceful skip under load. Verified against mock hang/reset/429/403/DNS-failure.