Inizia con Axe DevTools CLI

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

Guida rapida che copre le attività più comuni di Axe DevTools CLI

Not for use with personal data

Prima di iniziare, installa Axe DevTools CLI.

Axe DevTools CLI funziona tramite il comando axe . Questa guida copre le tre attività più comuni.

Analizza una Pagina Web

Passa uno o più URL direttamente al comando axe . Per impostazione predefinita, il CLI utilizza Firefox ed esegue il set di regole WCAG 2.1 AA , stampando i risultati su stdout:

axe https://example.com/

Analizza più pagine contemporaneamente:

axe https://example.com/ https://example.com/about.html

Salva i risultati come un file JSON per uso futuro:

axe https://example.com/ --save=./axe-results.json

Genera un report HTML direttamente:

axe https://example.com/ --report=./axe-reports/

Per tutte le opzioni, vedi Analizza Pagine.

Analizza Pagine Usando un File Spec

Per scenari più complessi come la navigazione attraverso un'app a pagina singola, il login, la chiusura di finestre di dialogo o l'analisi di una pagina in più punti di un flusso di lavoro, utilizza il comando axe spec con un file spec.

Un file spec (JSON o YAML) definisce un elenco di pagine da analizzare e le azioni da eseguire su ciascuna pagina prima dell'analisi. Un esempio minimo (axe-workflow.yaml):

projects:
  - name: example
    id: example
    pageList:
      - name: Homepage
        url: https://example.com/
      - name: Search Results
        url: https://example.com/
        actions:
          - type "axe" into element "#searchform input"
          - click element "#searchform button[type=submit]"
          - wait for element ".search-results" to be found
          - analyze

Eseguilo con axe spec, specificando il file spec e una directory di output per i risultati:

axe spec ./axe-workflow.yaml ./axe-results

Per un riferimento completo sulla struttura del file spec, azioni e opzioni, vedi Analizza Pagine Usando un File Spec.

Genera un Report dai Risultati Salvati

Usa il comando axe reporter per convertire i risultati JSON salvati in HTML, JUnit XML o CSV:

axe reporter ./axe-results --format=html

Genera un report JUnit XML (utile nei pipeline CI):

axe reporter ./axe-results --format=junit

Genera un report CSV:

axe reporter ./axe-results --format=csv

Per il filtraggio e altre opzioni, vedi Genera Report.

Prossimi Passi