Migrazione ad axe DevTools per Web v4.x CLI
Passaggi per la migrazione alla versione 4.x di axe DevTools per Web CLI
Per migrare da AGet ad axe DevTools per Web CLI, procedere come segue:
-
Disinstalla AGet
-
Segui le istruzioni di installazione
-
Script di aggiornamento che utilizzano AGet e utilizzare invece axe DevTools per Web CLI.
-
Se stai utilizzando un set di regole personalizzato, assicurati di rigenerarlo per axe-core 4.0. Inoltre:
- Se si utilizza ATTEST_PATH, modificarlo in AXE_RULESET_PATH.
- Se hai utilizzato un file locale
attest.json
, rinominalo inaxe-ruleset.json
.
-
Se si utilizza la CLI attest-reporter, sostituirla con axe reporter.
-
Se si utilizza la CLI attest-standards, sostituirla con axe ruleset.
Disinstallazione
Disinstallare l'eseguibile AGet
L'unica cosa necessaria per disinstallare AGet è eliminarlo dal file system. Se non sei sicuro di dove è installato, digita nella riga di comando which aget
.
Disinstallare il pacchetto AGet
Per disinstallare AGet da un pacchetto locale, esegui npm remove @deque/aget
. Per rimuovere AGet globalmente, aggiungere il flag a questo comando -g
. Se si utilizza il pacchetto AGet non limitato, inserisci remove aget
invece di remove @deque/aget
.
Aggiorna script
Cerca eventuali script che utilizzano AGet, lì sarà necessario sostituire il comando aget
con axe
. Tieni presente che questi script possono risiedere in diversi luoghi, ad esempio:
- file di script bash
- File di configurazione CI
- script di test
- file di configurazione del pacchetto
In axe DevTools per Web 4.0, il comando "uri" è stato deprecato. In alternativa, gli URL possono essere passati direttamente al comando "axe". Per migrare, rimuovi "uri" da tutti i comandi axe che lo utilizzano.
aget uri deque.com
In axe DevTools per Web 4.0, questo diventa:
axe deque.com
Aggiorna a axe reporter
Attest-reporter non è più disponibile come CLI autonoma. Il reporter è ora disponibile come parte di axe DevTools per Web CLI.
- Assicurati di disinstallare
attest-reporter
- Aggiorna script da utilizzare
axe reporter
al posto diattest-reporter
Passa al set di regole di axe
attest-standards non è più disponibile come CLI autonoma. La generazione di standard è ora disponibile come parte di axe DevTools per Web CLI.
- Assicurati di disinstallare
attest-standards
- Aggiorna script da utilizzare
axe ruleset
invece diattest-standards
Cambiamenti degni di nota
Oltre alle modifiche apportate all'installazione e all'utilizzo dei comandi descritti, ecco alcune modifiche degne di nota:
- Il set di regole Axe non supporta più le
matches
funzioni di regole personalizzateevaluate
e leafter
funzioni di controllo. È possibile utilizzare l'ID solo con le funzioni axe integrate.