open-testing-convert-puppeteer

name	open-testing-convert-puppeteer
description	Convert Puppeteer test suites (`puppeteer.launch`, `page.goto`, `page.click`, `page.type`, `page.$`/`page.$$`, `page.waitForSelector`, `page.evaluate`, typically paired with Jest/Mocha) to and from Selenium, Playwright, Cypress, Appium, Cucumber, Eggplant (SenseTalk), OpenTest.AI, Testers.AI Recorder, and Testers.AI Dynamic. Handles Puppeteer-core and full Puppeteer, headless/headed modes, ARIA selectors, XPath, network interception via `page.setRequestInterception`, and iframe/worker handling. Use whenever the user wants to migrate a Puppeteer suite, port Puppeteer tests to Playwright/Selenium/Cypress, or round-trip through OpenTest.AI. MANDATORY TRIGGERS — "convert Puppeteer", "Puppeteer to <target>", "Puppeteer to Playwright", "migrate Puppeteer", "port Puppeteer", "puppeteer-core to Playwright", any mention of Puppeteer alongside any supported target.
license	MIT
metadata	{"family":"open-testing-convert","source":"puppeteer","orchestrator":"open-testing-convert","targets":["selenium","playwright","cypress","appium","cucumber","eggplant","opentestai","testersai-recorder","testersai-dynamic"]}

Convert — Puppeteer

Converts Puppeteer test suites to any supported target. Defers orchestration to open-testing-convert.

When to use

Trigger when:

• Imports like import puppeteer from 'puppeteer' or const puppeteer = require('puppeteer-core').
• Calls puppeteer.launch(...), browser.newPage(), page.goto(...), page.click(...), page.type(...), page.$(...), page.$$(...), page.waitForSelector(...), page.evaluate(...), page.screenshot(...).
• Paired with a test runner (Jest, Mocha, Jasmine, or bare Node runner).
• jest-puppeteer preset (jest-puppeteer.config.js, global-teardown.js).

How to use

1. Read the master orchestrator first.
2. Detect runner (Jest/Mocha/bare). Runner-specific lifecycle extraction differs.
3. Determine puppeteer vs puppeteer-core — core is thinner, launches externally. Canonical behaviour is identical.
4. Read target primer for your target.
5. Read this skill's reference files: source-profile.md, extraction.md, mappings.md.
6. Emit per target Emission Checklist.

Scope

• Puppeteer 20+ (with ARIA selectors).
• Puppeteer legacy (pre-20, CSS-only by default).
• puppeteer-core (headless-shell or external Chromium path).
• Jest + jest-puppeteer preset.
• Mocha/Jasmine standalone with beforeAll/afterAll browser lifecycle.
• Bare Node scripts using Puppeteer for crawling/scraping (converted to tests with synthesized describe/it).

Out of scope

• Puppeteer Sharp (C#) — separate skill trigger (not in the catalogue).
• Headless Chrome via raw CDP (Chrome DevTools Protocol) — route separately.

Canonical-intent coverage notes

Puppeteer → Playwright is the smoothest translation in this catalogue (shared mental model, overlapping API). Other targets incur the usual mapping cost.

Quick reference

Puppeteer	Canonical	Target example
page.goto(url)	{kind: "navigate", url}	Playwright page.goto; Cypress cy.visit
page.click(sel)	{kind: "click", locator}	framework-specific
page.type(sel, v)	{kind: "input", locator, value: v}	framework-specific
page.$eval(sel, fn)	{kind: "js_exec", locator, code}	preserve if target supports
page.waitForSelector(sel)	{kind: "wait_for", wait_kind: "element_visible"}	framework-specific
page.waitForResponse(url)	{kind: "wait_for", wait_kind: "response", url}	Playwright waitForResponse; Cypress cy.wait('@alias')
ARIA: page.$('aria/Sign in[role="button"]')	{kind: "click", locator: {role: "button", name: "Sign in"}}	Playwright getByRole
page.screenshot({path})	{kind: "screenshot", name}	framework-specific

See reference/mappings.md for the full cookbook.