Installazione del Connettore Axe DevTools Linter come pacchetto npm

Questo articolo descrive come scaricare e installare il connettore Axe DevTools utilizzando Agora come registro dei pacchetti npm. Facendo così, è possibile sfruttare l'infrastruttura fornita da Node.js e npm per scaricare, versionare e aggiornare il binario del connettore Axe DevTools Linter, evitando i passaggi manuali richiesti quando si scarica il connettore direttamente tramite la pagina pagina dei download.

Cos'è Agora?

Agora è il repository di Deque (ospitato da JFrog come fabbrica di artefatti o artifactory), che memorizza in modo sicuro artefatti binari (pacchetti, librerie ed eseguibili) e richiede un account per l'accesso. 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 il tuo pagina profilo di Agora per ottenere un token di identità. (Se non sei connesso ad Agora, potresti essere reindirizzato a una pagina di destinazione diversa rispetto alla tua pagina di profilo dopo l'accesso. Clicca una seconda volta su stesso link dopo il login per andare alla tua pagina di profilo. Oppure, clicca sul pulsante a destra del pulsante di aiuto nell'angolo in alto a destra e poi clicca su Modifica Profilo.)
2. Fai clic 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 di identità Agora, puoi configurare il tuo file .npmrc per abilitare l'uso dell'infrastruttura npm per l'installazione del connettore.

1. Visita il sito Configurare l'Accesso ai pacchetti Agora per creare la configurazione da incollare nel tuo file .npmrc. 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. Fai clic su Genera Configurazione per creare una configurazione e clicca sull'icona di copia.
5. Incolla le righe copiate nel tuo file .npmrc. 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 di .npmrc

Di seguito è riportato un esempio delle righe che devono essere aggiunte alla 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 connettore globalmente. 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 manualmente il tuo .npmrc.