Installazione del Connettore Axe DevTools Linter come pacchetto npm

Questo articolo descrive come scaricare e installare il Connettore Axe DevTools utilizzando Agora come registro di pacchetti npm. In questo modo, puoi sfruttare l'infrastruttura fornita da Node.js e npm per scaricare, gestire le versioni e aggiornare il binario del Connettore Axe DevTools Linter, evitando i passaggi manuali richiesti quando scarichi il Connettore direttamente tramite la pagina dei download .

Cos'è Agora?

Agora è il repository di Deque (ospitato da JFrog come una fabbrica di artefatti o artifactory), che memorizza in modo sicuro gli artefatti binari (pacchetti, librerie ed eseguibili) e richiede un account per accedervi. Agora ospita il Connettore Axe Linter (sia il pacchetto npm che l'eseguibile scaricabile manualmente).

Crea un Token Identità Agora

Il primo passo è creare un token identità che npm utilizzerà per autenticare la tua sessione Agora. I token identità di Agora scadono dopo un anno, quindi devono essere ricreati annualmente.

1. Visita la tua pagina profilo di Agora per ottenere un token identità. (Se non sei connesso ad Agora, potresti essere reindirizzato a una pagina di destinazione diversa dalla tua pagina profilo dopo il login. Clicca il stesso link una seconda volta dopo aver effettuato il login per andare alla tua pagina profilo. Oppure clicca il pulsante a destra del pulsante di aiuto nell'angolo in alto a destra, e poi clicca su Modifica Profilo.)
2. Clicca su Genera un Token Identità.
3. Aggiungi una descrizione per aiutare a identificare il token in futuro. (Opzionale)
4. Clicca sull'icona di copia per copiare il token identità negli appunti. (Potresti voler salvare questo token identità in un gestore di password perché non puoi recuperarlo di nuovo.)

Configura il tuo .npmrc

Ora che hai un token identità di Agora, puoi configurare il tuo .npmrc file per abilitare l'uso dell'infrastruttura npm per installare il Connettore.

1. Visita il sito Configurare l'Accesso ai pacchetti Agora per creare la configurazione da incollare nel tuo .npmrc file. Nota che nessuna delle informazioni su questa pagina viene memorizzata o trasmessa.
2. Aggiungi il tuo indirizzo email (deve essere quello con cui sei registrato sul sito Agora).
3. Incolla il tuo token identità nella casella di testo corrispondente.
4. Clicca su Genera Configurazione per creare una configurazione e clicca sull'icona di copia.
5. Incolla le righe copiate nel tuo .npmrc file. Il percorso del file è specificato sul sito per Linux, macOS e Windows.

Dopo aver seguito questi passaggi, puoi utilizzare il pacchetto npm del Connettore Axe DevTools Linter.

Esempio .npmrc

Di seguito è riportato un esempio delle righe che devono essere aggiunte alla tua configurazione .npmrc :

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="am9obmRvZUBleGFtcGxlLmNvbTpUaGlzIGlzbid0IGEgdmFsaWQgaWRlbnRpdHkgdG9rZW4K"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=johndoe@example.com
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Il valore incluso con _auth è la codifica base64 di <email>:<identity-token>.

//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_authToken="VGhpcyBpc24ndCBhIHZhbGlkIGlkZW50aXR5IHRva2VuCg=="

Installazione e Utilizzo

Puoi installare l'ultima versione di Axe DevTools Connector con:

npm install @axe-devtools/axe-linter-connector -g

Questo comando installa il Connector a livello globale. Verifica l'installazione usando l'opzione --version :

axe-linter-connector --version

Prossimi Passi

• Consulta la documentazione per il Connector Axe Linter.
• (Documentazione esterna di JFrog) Collega il tuo client npm ad Artifactory per una discussione dettagliata su come configurare il tuo .npmrc manualmente.