open-testing-convert-taiko

name	open-testing-convert-taiko
description	Convert Taiko browser automation scripts (`goto`, `click`, `write`, `into`, `textBox`, `link`, `button`, `text`, `near`, `below`, `toLeftOf`, `openBrowser`, `closeBrowser`) to and from Selenium, Playwright, Cypress, WebDriverIO, Puppeteer, Appium, Cucumber, Eggplant (SenseTalk), TestCafe, Nightwatch, CodeceptJS, OpenTest.AI, Testers.AI Recorder, and Testers.AI Dynamic. Handles Taiko's natural-language API, relative/proximity locators, REPL-driven recording, Chromium-only backend, and Gauge BDD integration. Use whenever the user wants to migrate a Taiko suite, port Taiko tests to Playwright/Cypress, or round-trip Taiko through OpenTest.AI. MANDATORY TRIGGERS — "convert Taiko", "Taiko to <target>", "migrate Taiko", "port Taiko", "taiko.json", any mention of Taiko alongside any supported target.
license	MIT
metadata	{"family":"open-testing-convert","source":"taiko","orchestrator":"open-testing-convert","targets":["selenium","playwright","cypress","webdriverio","puppeteer","appium","cucumber","eggplant","testcafe","nightwatch","codeceptjs","opentestai","testersai-recorder","testersai-dynamic"]}

Convert — Taiko

Converts Taiko automation scripts to any supported target, and emits Taiko from any source.

When to use

Trigger when:

• Imports: const { goto, click, write, textBox, button, text, into, near, below, openBrowser, closeBrowser } = require('taiko').
• package.json with taiko dep.
• .taikorc / taiko.json / taikorc.json config.
• REPL-origin scripts: headers/comments like // Powered by Taiko Recorder.
• Paired with Gauge: specs/ folder with .spec files + tests/step_implementations/.
• API style: first-class proximity locators (near, below, above, toLeftOf, toRightOf).

How to use

1. Read the master orchestrator first.
2. Read this skill's reference files: source-profile.md, extraction.md, mappings.md.
3. Read target primer for your target.
4. Emit per target Emission Checklist.

Scope

• Taiko 1.x / 2.x.
• Standalone scripts and Gauge-backed specs.
• Selector builders: textBox, button, link, image, checkBox, radioButton, dropDown, fileField, color, range, text, $.
• Relative locators: near, below, above, toLeftOf, toRightOf, within.
• Lifecycle: openBrowser, closeBrowser, openTab, closeTab, goto, reload.
• Interactions: click, doubleClick, rightClick, write, attach, press, hover, dragAndDrop, scrollTo, scrollUp, scrollDown, focus.
• Assertions via Node assert / Chai / Gauge's assert.
• Emulation: device emulation, geolocation, network, permission.

Out of scope

• Taiko REPL interactive mode — use exported script.
• Screencast / video recording config — metadata only.
• Gauge-specific features (step parameters, tables, concepts) — preserve but don't transform.

Quick reference

Taiko	Canonical	Example target
await goto(u)	{kind: "navigate", url: u}	Playwright page.goto
await click('Sign in')	{kind: "click", locator: {strategy: "semantic_text", value: "Sign in"}}	framework-specific
await write('x', into(textBox('Email')))	{kind: "input", locator: {strategy: "semantic_field", value: "Email"}, value: "x"}	framework-specific
await click('Submit', below('Email'))	{kind: "click", locator: {semantic_text, proximity: {below: "Email"}}}	framework-specific
assert.ok(await text('Welcome').exists())	{kind: "assert", assertion_kind: "text_visible", value: "Welcome"}	framework-specific

See reference/mappings.md for full cookbook.