DequeのAgoraからAxe DevTools for WebをWebdriverIO用にインストールする

内部のアーティファクトリポジトリを持たないお客様で、Axe DevToolsを直接ダウンロードするよりも持続可能でスケーラブルなインストール方法を希望する場合、Dequeは選ばれたお客様に自社のアーティファクトリポジトリを提供しています。他のAxe DevToolsのインストール方法について詳しくは、バンドルからのインストールまたはアーティファクトリポジトリからのインストールのガイドを参照してください。

前提条件

AgoraからAxe DevToolsをインストールするには、Agoraのログイン資格情報が必要です。また、既存のNodeJSベースのウェブプロジェクトとWebdriverIOが必要です。テスト環境の構成に応じて、テストライブラリが追加の依存関係として必要になる場合があります。

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

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

認証情報を追加する

NPMまたはYarnを通じてAxe DevToolsパッケージにアクセスするには、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>をbase-64エンコードしてその出力を生成し、curlコマンドで生成したのと同じ方法で~/.npmrcファイルに追加することができます。

インストール

プロジェクトにAxe DevTools Puppeteerをインストールするには、このコマンドを実行してください:

npm install @axe-devtools/webdriverio

次のステップ

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

Axe DevToolsのインストールに問題がある場合は、直接Dequeの担当者に連絡するか、サポートデスクを通じて私たちに問い合わせるか、メールを送るしてください。私たちは喜んで支援いたします。