DequeのAgoraからインストールするAxe DevTools for WebDriverJS

独自のアーティファクトリポジトリを持っていないお客様や、Axe DevToolsを直接ダウンロードするよりも持続可能でスケーラブルなインストールソリューションを求めているお客様には、Dequeが専用のアーティファクトリポジトリを提供しています。Axe DevToolsを他の方法でインストールする方法については、アーティファクトリポジトリからのインストールまたはデモプロジェクトをダウンロードするのガイドをご覧ください。

前提条件

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

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

アイデンティティトークンを作成する最も簡単な方法は、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 WebDriverJSをインストールするには、このコマンドを実行します：

npm install @axe-devtools/webdriverjs

次のステップ

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

Axe DevToolsのインストールに問題がある場合は、Dequeの担当者に直接連絡するか、当社のサポートデスクを通じてお問い合わせいただくか、メールを送信してください。問題の解決をお手伝いいたします。