DequeのAgoraからNode.js用Axe DevToolsをインストールする

内部アーティファクトリポジトリを持たないお客様で、Axe DevToolsを直接ダウンロードするよりも持続可能でスケーラブルなインストール方法を希望する場合、Dequeは選ばれたお客様に自身のアーティファクトリポジトリを提供しています。このガイドでは、DequeのAgoraアーティファクトリポジトリからAxe DevTools Node.jsパッケージをインストールする方法について説明します。Axe DevToolsをインストールする他の方法についての情報は、アーティファクトリポジトリからのインストールをご覧ください。

前提条件

AgoraからAxe DevToolsをインストールするには、Agoraのログイン情報が必要です。また、Axe DevToolsをインストールするための既存のNode.jsベースのウェブプロジェクトも必要です。お客様のテスト環境の構成によっては、テストライブラリ（例えば、Cypress、Playwright、Puppeteer、WebdriverIO、WebDriverJS）が追加の依存関係として必要になることがあります。

アイデンティティトークンの作成

The simplest way to create an Identity Token is through the Agoraウェブアプリ. Once logged in, you can create an Identity Token by clicking the button labeled ようこそ あなたのメールアドレス in the top bar next to the help button. From there, you can create and copy your Identity Token.

認証の追加

Axe DevToolsパッケージにNPMまたはYarnを介してアクセスするには、Agora認証情報を~/.npmrcファイルに追加する必要があります。Agoraパッケージへのアクセスを設定するツールからAgoraのメールとアイデンティティトークンを使用して、.npmrc内容を生成することができます。手動で行う場合、最も簡単なのはcurlコマンドを使用することです。

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

このコマンドを実行する際には、をAgoraのログインメールに、を前のステップでコピーしたアイデンティティトークンに置き換えてください。コマンドの返り値は以下のようになります。

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

.npmrcファイルの設定（yarn/npm）

編集のために~/.npmrcファイルを開いてください。まずレジストリ情報を追加し、その後curlコマンドの出力を追加してください。最終形は以下のようになります。

@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

.yarnrc.ymlファイルの設定（yarn modern）

編集のために~/.yarnrc.ymlファイルを開いてください。まずレジストリ情報を追加し、その後curlコマンドの出力を追加してください。最終形は以下のようになります。

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

curlコマンドを実行できない場合、<your-email>:<your-identity-token>をベース64でエンコードし、生成物をcurlコマンドで生成したように~/.npmrcファイルに追加して認証文字列を生成することができます。

インストール

認証が設定されると、テストライブラリ用のパッケージをインストールしてください。

ブラウザJavaScript (@axe-devtools/browser)

npm install @axe-devtools/browser

インストールが完了したら、インポートと初期化のガイドを読んでください。

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Cypress自体をまだインストールしていない場合は、次のコマンドでインストールできます

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Playwright自体をまだインストールしていない場合は、次のコマンドでインストールできます

npm install playwright

インストールが完了したら、インポートと初期化のガイドを読んでください。

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Puppeteer自体をまだインストールしていない場合は、次のコマンドでインストールできます

npm install puppeteer

インストールが完了したら、インポートと初期化のガイドを読んでください。

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

インストールが完了したら、インポートと初期化のガイドを読んでください。

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

インストールが完了したら、インポートと初期化のガイドを読んでください。

次のステップ

Axe DevToolsのインストールに問題がある場合は、直接Dequeの担当者に連絡するか、当社のサポートデスクでお問い合わせいただくか、メールを送るしてください。スムーズにセットアップできるようお手伝いいたします。