Migración a Axe DevTools para Web v4.x para Node.js

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Pasos para migrar a la versión 4.x de Axe DevTools para Web para Node.js

Not for use with personal data

Axe DevTools NPM v4.x es una reescritura importante de todo el proyecto. Los cambios más notables se resumen a continuación, seguidos de cambios más específicos en los paquetes relevantes.

Resumen

La suite de paquetes npm axe-devtools-*, implicó un cambio de marca así como la unificación de herramientas de integración para ser más específicas a la experiencia del desarrollador.

Con esto en mente, todos los paquetes han sido renombrados para utilizar el espacio de nombres axe devtools y los binarios se han combinado en un único paquete binario.

Cuidado con los cambios importantes

Dado el cambio de marca de la API, es justo señalar que la migración a v4.0 implica seguir esta guía de migración paso a paso.

Configuración del Entorno

No hay cambios en los requisitos predeterminados. Los requisitos deseados son los siguientes:

Versión LTS de Node
NPM para dependencias de npm

Instalación de Paquetes NPM de Axe DevTools

Asegúrate de tener acceso a Deque's registry. Si no lo tienes, consulta la información de instalación para tu paquete:

Puedes instalar cualquiera de los paquetes npm a continuación incluyéndolos en el archivo package.json.

npm install @axe-devtools/browser

// package.json
{
  "@axe-devtools/browser": "^4.0.0"
}

Los paquetes npm disponibles son:

Por favor, consulta cada uno de los paquetes npm mencionados anteriormente para obtener instrucciones de uso y documentación detallada de la API.

Opcionalmente, se puede desinstalar las integraciones anteriores de node (para paquetes con o sin ámbito) ejecutando los siguientes comandos:

npm uninstall attest-js
npm uninstall @deque/attest-js

Cambios Destacables

Además de los cambios de instalación y uso con las gemas indicadas, algunos cambios destacables incluyen:

La variable de entorno para configurar reglas personalizadas ha cambiado de ATTEST_PATH a AXE_RULESET_PATH.
El conjunto de reglas predeterminado ha cambiado. Axe DevTools audita una página dada con wcag2 como el conjunto de reglas predeterminado. No se requiere ningún cambio por parte del usuario final. Si se desea configurar un conjunto de reglas diferente, pueden usar @axe-devtools/cli para generar un conjunto de reglas diferente o crear un archivo axe-ruleset.json con sus conjuntos de reglas deseados.
Todos los paquetes utilizarán axe-core v4.0.X.
Axe DevTools WebdriverIO ya no admitirá WebdriverIO v4 y ahora solo admitirá WebdriverIO v5 y v6.

Cambios en los binarios

Attest-standards y Attest Reporter ya no se enviarán con binarios. Toda la funcionalidad previa de los binarios estará incluida en @axe-devtools/cli como subcomandos. Para Axe DevTools 4.0, Attest-standards será descontinuado y no tendrá una versión 4.0.