ウェブ用Axe DevToolsのCypress APIリファレンス
@axe-devtools/cypressパッケージのAPIリファレンス
Cypressのチェーン可能なコマンド(分析)
cy.axeAnalyze()
このチェーン可能なコマンドは、 axe をすべてのページとiframeに挿入し、 axe をページで実行します。
| パラメータ | 型 | デフォルト値 | 説明 |
|---|---|---|---|
| name(オプション) | 文字列 | 未定義 | レポートに保存されるこのスキャン結果の識別子を設定します。提供されない場合は、タイムスタンプがデフォルトとして設定されます。 |
| context(オプション) | axe.ElementContext | 未定義 | 分析の範囲を定義します。通常はドキュメントやクラス名、ID、セレクタなどの特定のセレクタになります。 |
| options(オプション) | axe.RunOptions | 未定義 | 一時的にルールやチェックを変更するために渡されるオプションのセットです。 axe.configure、これはより永久的なものです。 |
| log(オプション) | ブール値 | false | アクセス可能でない要素の数と違反の影響をテーブルとしてstdoutに出力します。 |
cy.isAxeClean()
このチェーン可能なコマンドは、ページにアクセシビリティの違反がないことを確認するためのアサーションです。
パラメータ:
| パラメータ | 型 | デフォルト値 | 説明 |
|---|---|---|---|
| context(オプション) | axe.ElementContext | 未定義 | 分析の範囲を定義します。通常はドキュメントやクラス名、ID、セレクタなどの特定のセレクタになります。 |
| options(オプション) | axe.RunOptions | 未定義 | 一時的にルールやチェックを変更するために渡されるオプションのセットです。 axe.configure、これはより永久的なものです。 |
Cypressのチェーン可能なコマンド(設定)
CypressとAxe DevTools for Webを統合し、カスタムのCypressのチェーン可能なコマンドを使用して分析結果を設定します。
cy.setAxeSource()
このチェーン可能なコマンドは、axe-coreのバージョンを設定します。
| パラメータ | 型 | デフォルト値 | 説明 |
|---|---|---|---|
| ファイルパス(必須) | 文字列 | null | プロジェクトのルートからの相対パス。含める必要があるのは、 axe.source またはaxe-coreの圧縮版です。 |
cy.setAxeCustom()
このチェイン可能なコマンドでは、カスタムのルールセットを使用できます。
- Axe DevTools for Web Cypressもまた、
axe-ruleset.jsonプロジェクトのルートレベルに配置した場合に暗黙的に読み込みます。また、AXE_RULESET_PATH環境変数が設定されている場合にはカスタムルールセットファイルを使用します。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| ファイルパス(必須) | 文字列 | null | プロジェクトのルートからの相対パス。チェックとルールを含める必要があります |
cy.setAxeRuleset()
このチェイン可能なコマンドでは、タグごとにルールを実行することができます。設定方法は axe.run()と似ています。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| ルールセット(必須) | '508', 'en301549', 'rgaav4', 'ttv5', 'wcag2', 'wcag2.1', 'wcag2.2', 'wcag2aaa', 'wcag2.1aaa', 'wcag2.2aaa' | 'wcag2.1' | このルールが割り当てられたタグの配列です。 |
cy.setAxeReportName()
このチェイン可能なコマンドでは、レポートファイルの名前を設定できます。
| パラメータ | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
| レポート名(必須) | 文字列 | @axe-devtools-cypress | レポートファイルの名前です。 |
cy.getAxeResults()
このチェイン可能なコマンドでは、 cy.axeAnalyze()実行後の結果を利用できます。
からのレスポンスは getAxeResults() データの形式を返します。 axe.AxeResults。
例:
after(() => {
cy.axeAnalyze();
cy.getAxeResults().then(data => {
cy.writeFile('./results.json', data)
})
})cy.getUniversalResults()
このチェイン可能なコマンドは、最新の cy.axeAnalyze() 呼び出しの結果を Axe Universal Formatで返します。 null 解析がまだ実行されていない場合は
例:
after(() => {
cy.axeAnalyze();
cy.getUniversalResults().then(data => {
cy.writeFile('./results-universal.json', data)
})
})使用サービス
使用サービスは、組織内でのAxe DevTools for Webの利用傾向を洞察することを可能にします。
環境変数
これらの環境変数を使用すると、使用サービスを構成し、報告されたイベントのプロパティを変更することができます。
| 名前 | タイプ | 上書き可能 | 説明 |
|---|---|---|---|
AXE_DISTINCT_ID |
文字列 | — | ログイン中のユーザーに対して同一であるUUID識別子(再生成されない限り) |
AXE_METRICS_URL |
文字列 | — | REST使用エンドポイントのURL |
AXE_TRACK_USAGE |
ブール値 | — | 使用サービスレポートを有効にします(デフォルトは false) |
AXE_APPLICATION |
文字列 | false | アクセシビリティエラーのチェックに使用されたアプリケーション |
AXE_DEV_INSTANCE |
ブール値 | true | このイベントがソフトウェア開発者の行動によるものかを示します。開発またはテスト中に記録されたイベントをマークし、後で削除するのに便利です。 |
AXE_DEPARTMENT |
文字列 | true | 組織内でのユーザーの部署 |
AXE_KEYCLOAK_ID |
文字列 | false | ユーザーのKeycloak ID |
AXE_LOGGED_IN |
ブール値 | false | テスト対象アプリケーションにユーザーがログインしているかどうかを記録します |
AXE_ORGANIZATION |
文字列 | true | ユーザーの組織 |
AXE_SESSION_ID |
文字列 | false | ユーザーのセッションを識別するUUID |
AXE_USER_ID |
文字列 | false | 特定のユーザーの名前やログインIDなどのアイデンティティ |
AXE_USER_JOB_ROLE |
文字列 | false | ユーザーの役割 |
AXE_USER_STATUS |
文字列 | false | ユーザーに紐づけたいステータス情報 |
cy.task('enableTracking', <boolean>)
このCypressタスクは、ユーザーが使用サービスにデータを送信することを選択することを可能にします。
cy.task('setTrackingUrl', <string>)
このCypressタスクは、使用状況メトリクスデータの送信先を変更することを可能にします。
cy.task('setDistinctId', <string>)
このCypressタスクは、保存または使用される固有のIDを変更することを可能にします。
次のステップ
Axe DevTools for Webのインストールに関して問題がある場合は、直接Deque担当者に連絡するか、私たちの サポートデスクを通じて質問するか、 メールを送信してください。喜んでお手伝いいたします。
