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

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

前提条件

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

IDトークンの作成

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

認証の追加

Axe DevToolsパッケージにNPMまたはYarnを通じてアクセスするには、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 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エンコードして生成された認証文字列を~/.npmrcファイルにcurlコマンドで生成されたものとして追加することができます。

インストール

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

npm install @axe-devtools/playwright

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

npm install playwright

次のステップ

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

Axe DevToolsのインストールに問題がある場合は、Dequeの担当者に直接連絡するか、私たちのサポートデスクまたはメールを送るでお尋ねください。セットアップと稼働をサポートさせていただきます。