Installa Axe DevTools per il Web per Node.js da Agora di Deque

Per i clienti che non dispongono di un repository di artefatti interno e desiderano una soluzione più sostenibile e scalabile rispetto al download diretto di Axe DevTools, Deque mette a disposizione il proprio repository di artefatti per clienti selezionati. Questa guida copre l'installazione di qualsiasi pacchetto Node.js di Axe DevTools dal repository di artefatti Agora di Deque. Per informazioni su altri modi di installare Axe DevTools, consulta la guida su Installazione dal tuo Artifact Repository.

Prerequisiti

Per installare Axe DevTools da Agora, è necessario avere le credenziali di accesso ad Agora. Inoltre, devi avere un progetto web esistente basato su Node.js in cui installare Axe DevTools. A seconda della configurazione del tuo ambiente di test, potrebbe essere necessario un ulteriore dipendenza della libreria di test (ad esempio, Cypress, Playwright, Puppeteer, WebdriverIO o WebDriverJS).

Creazione di un Token di Identità

Il modo più semplice per creare un Token di Identità è tramite la webapp di Agora. Una volta effettuato l'accesso, puoi creare un Token di Identità cliccando il pulsante etichettato Benvenuto il-tuo-indirizzo-email nella barra superiore accanto al pulsante di aiuto. Da lì, puoi creare e copiare il tuo Token di Identità.

Aggiunta dell'Autenticazione

Per accedere ai pacchetti Axe DevTools tramite npm o Yarn, sarà necessario aggiungere le informazioni di autenticazione di Agora a un file ~/.npmrc. Lo strumento Configurazione dell'Accesso ai pacchetti Agora può generare questo contenuto .npmrc per te dal tuo email di Agora e dal Token di Identità. Altrimenti, il modo più semplice per farlo manualmente è con un comando curl.

curl -u "your-email:your-identity-token" "https://agora.dequecloud.com/artifactory/api/npm/auth"

Quando esegui questo comando, sostituisci your-email con la tua email di accesso ad Agora, e sostituisci your-identity-token con il Token di Identità che hai copiato nel passaggio precedente. Mantieni le virgolette e non aggiungere parentesi angolari intorno ai valori sostituiti: nella maggior parte delle shell < e > sono operatori di redirezione, quindi lasciandoli il comando fallisce con un errore fuorviante. Il risultato del comando dovrebbe apparire così:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Configurazione del tuo file .npmrc (yarn/npm)

Apri il tuo file ~/.npmrc per la modifica. Aggiungi prima le informazioni del registro, poi aggiungi il risultato del comando curl. Il prodotto finale dovrebbe apparire così:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth=<generated-auth-string>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email@email.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Configurazione del tuo file .yarnrc.yml (yarn moderno)

Apri il tuo file ~/.yarnrc.yml per la modifica. Aggiungi prima le informazioni del registro, poi aggiungi il risultato del comando curl. Il prodotto finale dovrebbe apparire così:

npmScopes:
  axe-devtools:
    npmRegistryServer: 'https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/'
    npmAlwaysAuth: true
    npmAuthIdent: <generated-auth-string>

Se non riesci a eseguire comandi curl, puoi generare la stringa di autenticazione codificando in base-64 la tua email di Agora e il Token di Identità nella forma your-email:your-identity-token, quindi aggiungendo il risultato al file ~/.npmrc allo stesso modo in cui verrebbe generato con il comando curl.

Installazione

Una volta configurata l'autenticazione, installa il pacchetto per la tua libreria di test.

Browser JavaScript (@axe-devtools/browser)

npm install @axe-devtools/browser

Una volta installato, leggi la guida su importazione e inizializzazione.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Se non hai ancora installato Cypress, puoi installarlo con il comando

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Se non hai ancora installato Playwright, puoi installarlo con il comando

npm install playwright

Una volta installato, leggi la guida su importazione e inizializzazione.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Se non hai ancora installato Puppeteer, puoi installarlo con il comando

npm install puppeteer

Una volta installato, leggi la guida su importazione e inizializzazione.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Una volta installato, leggi la guida su importazione e inizializzazione.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Una volta installato, leggi la guida su importazione e inizializzazione.

Prossimi Passi

Se hai problemi a installare Axe DevTools, contatta direttamente il tuo rappresentante Deque, chiedi a noi tramite il nostro supporto tecnico o inviaci un'email. Saremo felici di aiutarti a cominciare.