ウェブ用Axe DevToolsのCypress APIリファレンス

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

@axe-devtools/cypressパッケージのAPIリファレンス

Not for use with personal data

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担当者に連絡するか、私たちの サポートデスクを通じて質問するか、 メールを送信してください。喜んでお手伝いいたします。