open-testing-convert-webdriverio

name	open-testing-convert-webdriverio
description	Convert WebDriverIO test suites (`browser.*`, `$()`/`$$()` element queries, `waitForDisplayed`, WebdriverIO's shorthand selector prefixes like `~`, `android=`, `-ios predicate string:`) to and from Selenium, Playwright, Cypress, Appium, Cucumber, Eggplant (SenseTalk), OpenTest.AI, Testers.AI Recorder, and Testers.AI Dynamic. Handles WDIO Mocha/Jasmine/Cucumber specs, sync (v6) and async (v7+) APIs, mobile and desktop configurations, wdio.conf.js services, and shared hooks. Use whenever the user wants to migrate a WebDriverIO suite, port WDIO tests to another framework, or round-trip WDIO through OpenTest.AI. MANDATORY TRIGGERS — "convert WebDriverIO", "WebDriverIO to <target>", "WDIO to Playwright", "WDIO to Cypress", "wdio.conf.js", "migrate WDIO", any mention of WebDriverIO alongside any supported target.
license	MIT
metadata	{"family":"open-testing-convert","source":"webdriverio","orchestrator":"open-testing-convert","targets":["selenium","playwright","cypress","appium","cucumber","eggplant","opentestai","testersai-recorder","testersai-dynamic"]}

Convert — WebDriverIO

Converts WebDriverIO test suites to any supported target, and emits WebDriverIO from any source. Defers orchestration to open-testing-convert.

When to use

Trigger when:

• The user references WebDriverIO, wdio.conf.js/wdio.conf.ts, browser.url(...), $(...)/$$(...), ~accessibilityId, android=new UiSelector(), -ios predicate string:..., or @wdio/cli.
• The user uploads a spec file with describe/it/before/after plus await browser... or synchronous browser... calls.
• package.json contains @wdio/* packages.
• Mobile-flavour WDIO with capabilities: { platformName: "Android" }.

How to use

1. Read the master orchestrator first. ../open-testing-convert/SKILL.md.
2. Determine runtime flavour. WDIO 6 (sync Fiber-based) vs WDIO 7+ (async/await). Forward-convert from sync to async as an intermediate step — all code targets use async; the sync flavour only survives when emitting WDIO 6 back.
3. Detect backend. Web (Chromedriver/Geckodriver) vs Mobile (Appium) vs Desktop (Winium, etc.). Mobile WDIO routes through the same extraction as raw Appium; web routes through Selenium-like extraction.
4. Read target primer for your target (same catalogue as Selenium/Playwright/Cypress skills).
5. Read this skill's reference files:
   • reference/source-profile.md — WDIO API surface, selector prefixes, config structure, services.
   • reference/extraction.md — command → canonical intent.
   • reference/mappings.md — per-target cookbook.
6. Read shared references as needed.
7. Emit per target Emission Checklist. Preamble lists: WDIO version detected, sync vs async, backend (web/mobile), services used (e.g., wdio-sauce-service), selector strategy distribution.

Scope

• Mocha, Jasmine, and Cucumber runners (Cucumber paths delegate to open-testing-convert-cucumber for the feature-file layer).
• Sync (WDIO 6) and async (WDIO 7+) APIs.
• Web (standalone) and Mobile (Appium-backed) modes.
• WDIO custom commands (browser.addCommand).
• WDIO services (chromedriver, sauce, visual, shared-store).
• Page object pattern (WDIO's common POM style with getter-based selectors).
• Shared spec hooks via wdio.conf.js (beforeTest, afterSuite, etc.).

Out of scope

• WDIO with Cucumber features — the feature file itself is handled by open-testing-convert-cucumber; the step-defs are in scope here.
• Pure Appium raw code (no WDIO) — use open-testing-convert-appium.
• Old WDIO 4/5 without TypeScript/async patterns — preserved as a legacy fallback mode.

Quick reference

WDIO call	Canonical	Code target
browser.url('/x')	{kind: "navigate", url: "/x"}	page.goto/driver.get/cy.visit
$('#email').setValue('x')	{kind: "input", locator: {strategy: "css", value: "#email"}, value: "x"}	framework-specific input
$('~Sign in').click()	{kind: "click", locator: {strategy: "accessibility_id", value: "Sign in"}}	AppiumBy.accessibilityId / getByRole on web
$('android=new UiSelector().text("X")').click()	{kind: "click", locator: {strategy: "android_uiautomator", value: "new UiSelector().text(\"X\")"}}	AppiumBy.androidUIAutomator
$('-ios predicate string:label == "X"').click()	{kind: "click", locator: {strategy: "ios_predicate", value: "label == \"X\""}}	AppiumBy.iOSNsPredicateString
expect(elem).toBeDisplayed()	{kind: "assert", assertion_kind: "element_visible", locator}	framework-specific
browser.waitUntil(() => ...)	{kind: "wait_for", wait_kind: "custom_condition"}	framework-specific

See reference/mappings.md for full cookbook.