@healify/webdriverio-plugin

Wrapper de auto-sanado para WebdriverIO. Cuando una interacción con un elemento (click, setValue, etc.) falla porque el selector ya no existe en la página, este plugin intenta curarlo en vivo con una heurística de pattern-matching (no es IA, no hay red ni servidor). Es el mismo motor que usan @healify/test-runner (Playwright), @healify/cypress-plugin (Cypress) y @healify/selenium-plugin (Selenium): analyzeAndHeal().

Verifica contra la página real. En el momento exacto en que la interacción falla, el plugin todavía tiene el browser en la mano — consulta el DOM real ahí mismo (browser.execute) antes de proponer nada. Las sugerencias se confrontan contra lo que había de verdad en pantalla: se descarta lo que no existe, y los nombres se leen de la página en vez de deducirse por diccionario. Si execute no está disponible (sesión rara, browser sin soporte de JS), degrada limpio a la heurística sin verificar.

Instalación

npm install --save-dev @healify/webdriverio-plugin

Uso

import { remote } from 'webdriverio'
import { HealifyWebdriverIOPlugin } from '@healify/webdriverio-plugin'

const raw = await remote({ capabilities: { browserName: 'chrome' } })
const healify = new HealifyWebdriverIOPlugin({ onEvent: console.log })
const browser = healify.wrap(raw)

// Si '#add-to-cart-btn' se rompió, el plugin intenta un selector alternativo
// antes de dejar que el error se propague.
await browser.$('#add-to-cart-btn').click()

WebdriverIO es lazy: $() no falla hasta que interactuás con el elemento devuelto. El proxy envuelve los métodos de interacción (click, setValue, addValue, getText, getAttribute, waitForExist, waitForDisplayed, waitForClickable, isExisting, isDisplayed, getHTML, getLocation, getSize) para capturar el error en el momento correcto, no en $() mismo.

Opciones

new HealifyWebdriverIOPlugin({
  confidenceThreshold: 0.9,       // default: mismo piso que reporter-core (HEALED_THRESHOLD, auto-aplicado sin revisión)
  dryRun: false,                  // default: true = cura pero nunca aplica el fix, solo emite el evento
  onEvent: (e) => {},             // opcional: se llama en cada intento de curado
  projectName: 'mi-proyecto',     // opcional: nombre que va a healify-report.json al llamar flush()
})

Generar un reporte con flush()

Igual que Selenium, WebdriverIO no tiene un hook nativo de "fin de corrida" en este plugin, así que no genera healify-report.html/.json solo. Llamando flush() al final de tu suite (ej. en un after/afterAll global) se escribe healify-report.json con todos los eventos acumulados desde la última llamada, mismo formato que Playwright/Cypress/Selenium:

const healify = new HealifyWebdriverIOPlugin({ projectName: 'mi-proyecto' })
const browser = healify.wrap(raw)

// ... corré tu suite normalmente ...

const cantidad = healify.flush()   // escribe healify-report.json, devuelve cuántos casos escribió

healify-report.html no se genera acá (no hay renderer HTML en este paquete), pero podés correr npx @healify/cli fix sobre el healify-report.json resultante igual que con Playwright/Cypress.

Qué selectores soporta

WebdriverIO usa strings directos, no una clase de locators como By en Selenium: selectores CSS (.clase, #id, [attr=x], tag), XPath (//div, (//div)[1]).

Estrategias de string de WebdriverIO (linkText=, partialText=, xpath= explícito con prefijo, etc.) no están soportadas: no tienen equivalente limpio en el motor de heurística. Si se usan, el plugin no intenta curar y deja pasar el error original tal cual.

Fuera de alcance (a propósito, en esta versión)

• Modo cloud: no existe. Healify es 100% local, sin apiKey, sin servidor.
• Reporte HTML: flush() (arriba) escribe healify-report.json, pero este paquete no tiene un renderer de healify-report.html propio como test-runner/cypress-plugin.
• Memoria entre tests ("si otro test ya usa un selector estable, sugerirlo acá también"): el motor de heurística no tiene esta capacidad hoy, en ningún paquete de Healify. No se agregó solo para WebdriverIO.
• Sugerencias role(...) con nombre: se convierten a un XPath real ($() de WebdriverIO autodetecta XPath por el // inicial) que busca por texto visible, aria-label, placeholder o value según el rol — reconoce button, link, textbox, checkbox, radio y searchbox. Sin nombre (role('button'), típico de la estrategia XPath del motor) no hay con qué armar un XPath confiable, y se reporta como 'no-suggestion'.
• :has-text(...)/visible=.../getBy*(...): siguen siendo sintaxis de Playwright sin equivalente CSS/XPath directo — se reportan como 'no-suggestion'.

Licencia

MIT