Migración a axe DevTools for Web v4.x CLI
Pasos para migrar a la versión 4.x de axe DevTools for Web CLI
Para migrar de AGet a axe DevTools for Web CLI, siga los siguientes pasos:
-
Desinstale AGet
-
Siga las instrucciones de instalación
-
Scripts de actualización que usan AGet con axe DevTools for Web CLI en su lugar.
-
Si está utilizando un conjunto de reglas personalizado, asegúrese de regenerarlo para axe-core 4.0. Además:
- Si utiliza ATTEST_PATH, cámbielo a AXE_RULESET_PATH.
- Si está utilizando un archivo
attest.json
local, cámbiele el nombre aaxe-ruleset.json
.
-
Si está utilizando la CLI attest-reporter, reemplácela con axe reporter.
-
Si está utilizando la CLI attest-standards, reemplácela con axe ruleset.
Desinstalar
Desinstalar el ejecutable AGet
Lo único que se necesita para desinstalar AGet es eliminarlo de su sistema de archivos. Si no está seguro de dónde está instalado, escriba which aget
en la línea de comando.
Desinstalar el paquete AGet
Para desinstalar AGet de un paquete local, ejecute npm remove @deque/aget
. Para eliminar AGet globalmente, agregue la bandera -g
a este comando. Si está utilizando el paquete AGet sin alcance, escriba remove aget
en lugar de remove @deque/aget
.
Actualizar scripts
Busque cualquier script que use AGet, allí deberá reemplazar el comando aget
por axe
. Tenga en cuenta que estos scripts pueden residir en distintos lugares, como por ejemplo:
- archivos de script bash
- Archivos de configuración de CI
- scripts de prueba
- archivos de configuración del paquete
En axe DevTools for Web 4.0, el comando "uri" ha quedado obsoleto. En lugar de ello, las URL se pueden pasar directamente al comando "axe". Para migrar, elimine "uri" de todos los comandos axe que lo utilicen.
aget uri deque.com
En axe DevTools for Web 4.0, esto cambia a:
axe deque.com
Actualización a axe reporter
El reportero de attest ya no está disponible como una CLI independiente. El reportero ahora está disponible como parte de axe DevTools for Web CLI.
- Asegúrese de desinstalar
attest-reporter
- Scripts de actualización para usar
axe reporter
en lugar deattest-reporter
Actualizar el conjunto de reglas de axe
Los estándares de certificación ya no están disponibles como una CLI independiente. La generación de estándares ahora está disponible como parte de axe DevTools for Web CLI.
- Asegúrese de desinstalar
attest-standards
- Actualizar scripts para usar
axe ruleset
en lugar deattest-standards
Cambios notables
Además de los cambios de instalación y uso con los comandos descritos, algunos cambios dignos de mención incluyen:
- El conjunto de reglas de Axe ya no admite
matches
funciones de reglas personalizadasevaluate
funciones de comprobaciónafter
yfunciones. Solo puedes usar el ID para funciones integradas de axe.