DequeのAgoraでAxe DevTools for Web for Puppeteerをインストールする

内部アーティファクトリポジトリを持っておらず、Axe DevToolsを直接ダウンロードするよりも持続可能でスケーラブルなインストールソリューションを望むお客様には、Dequeが選ばれたお客様向けに独自のアーティファクトリポジトリを提供しています。Axe DevToolsの他のインストール方法については、バンドルからインストールまたはあなたのアーティファクトリポジトリからインストールのガイドをご覧ください。

前提条件

AgoraからAxe DevToolsをインストールするためには、Agoraのログイン認証情報が必要です。また、Axe DevToolsをインストールする既存のNodeJSベースのウェブプロジェクトを持っている必要があります。テスト環境の設定によっては、テスト用ライブラリが追加の依存関係として必要になる場合があります。

IDトークンの作成

最も簡単なIDトークンの作成方法はAgoraウェブアプリを使うことです。ログインしたら、ヘルプボタンの隣にあるトップバーのようこそ あなたのメールアドレスというラベルのボタンをクリックしてIDトークンを作成できます。そこからIDトークンを作成してコピーします。

認証の追加

NPMまたはYarnを通じてAxe DevToolsパッケージにアクセスするには、Agora認証情報を~/.npmrcファイルに追加する必要があります。最も簡単な方法はcurlコマンドを使用することです。

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

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

_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モダン）

編集のために~/.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>をbase-64エンコードして認証文字列を生成し、curlコマンドで生成したのと同じ方法で~/.npmrcファイルに追加できます。

インストール

プロジェクトにAxe DevTools Puppeteerをインストールするには、このコマンドを実行します。

npm install @axe-devtools/puppeteer

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

npm install puppeteer

次のステップ

Axe DevToolsが環境に正常にインストールされたら、インポートと初期化ガイドを読んでください。

Axe DevToolsのインストールに問題がある場合は、直接Dequeの担当者に連絡するか、サポートデスクを通じて質問するか、メールでお問い合わせしてください。お手伝いできることを喜ばしく思います。