Testers.AI SDKBETA powered by testers.ai
DocsIntegrationsFAQDownloads Get API key → Get the SDK →
Home/ JavaScript/ Puppeteer
JavaScript Puppeteer package: @testersai/puppeteer

Puppeteer × Testers.AI

The easiest way to AI-upgrade your existing Puppeteer 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 →
SharonSharonSecurityAIMarcusMarcusOWASPAIAlejandroAlejandroAccessibilityAIHiroshiHiroshiWCAGAIMiaMiaUsabilityAITariqTariqPerformanceAISophiaSophiaContentAIRichardRichardFormsAIFatimaFatimaError UXAIMeiMeiSearchAIZaraZaraNews / ContentAIYukiYukiLanding PagesAIHassanHassanCheckoutAIPriyaPriyaShopping CartAIMateoMateoPricing PagesAIPetePetePrivacy / PIIAIZaneleZaneleGDPRAIRajeshRajeshCookie ConsentAISundarSundarLegal PolicyAIJasonJasonAI Code ReviewAIDiegoDiegoAI ChatbotAI

Install

new TestersAIPage(page) wraps the puppeteer Page and hooks console/response events.

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

Example

A complete, runnable JavaScript / TypeScript + Puppeteer example.

const puppeteer = require('puppeteer');
const { TestersAIPage } = require('@testersai/puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  const ta = new TestersAIPage(page);

  await page.goto('https://example.com');
  await ta.analyzeScreenshot();

  await browser.close();
})();

How it flows

1
🧪
Your test runs
Puppeteer — unchanged.
2
📸
SDK captures
Screenshot, console, network, or page text.
3
🤖
Testers.AI analyses
Returns AI-identified issues.
4
📝
Puppeteer report
Findings shown where you already look.
5
🔗
Optional: auto-log
Jira · Xray · TestRail · Cypress Cloud.

Whatever test runner you're using. Default disk sink writes JSON to ./testersai-results. If the AI call fails — rate limit, hang, firewall, no network — the SDK gives up fast and returns a skipped result. Your Puppeteer 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 Puppeteer — pick the ones that fit your suite.

1

After every meaningful navigation

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

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

After a state-changing action

Login, add-to-cart, toggle, submit. The UI just reflected a new state — where regressions hide.

after click / fill
3

Right before your main assertion

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

before expect(...)
4

After async operations settle

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

after wait_for_selector
5

In teardown / afterEach

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

afterEach / teardown
6

On responsive / theme switch

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

after setViewport

Value: what you get for three extra lines

Download

⭐
testersai-javascript-puppeteer-0.1.0.tar.gz
Recommended. Core + the Puppeteer adapter — nothing else. Self-contained bundle.
~
↓
📦
testersai-sdk-0.1.0.tgz
Whole-language archive — @testersai/sdk core.
3.8 KB
↓

Or grab the monolith ZIP (all languages, all adapters).

Other JavaScript combinations

@playwright/testCypressJestMochaWebdriverIOVibium