アクセシビリティテストの自動化 axe-core と WCAG による検査。
Nexus StudioQA のアクセシビリティテスト自動化では、テスト終了時に実際のページに対して axe-core を実行し、違反が検出された各 WCAG 規則について、影響度と該当要素を一覧表示します。既定では参考情報としての通知にとどまります。厳格モードでは、合格したテストに重大以上の違反があると A11Y_VIOLATION と表示されます。自動検査で見つかるのはアクセシビリティの問題の一部に限られるため、人による確認の代わりにはなりません。
執筆: Verdict System LLCのNexus StudioQAチーム。
最終更新日: .
検査内容と有効にする方法
検査は明示的に有効にするまで無効です: 1 回の実行で有効にするには --a11y、毎回有効にするには NEXUS_A11Y_ENABLED=true を指定します。@axe-core/playwright の追加機能が必要です。未導入の場合、レポートには “未測定” と表示され、テストには影響しません。
| 設定 | 既定 | 主な機能 |
|---|---|---|
NEXUS_A11Y_ENABLED | false | テスト終了時に表示されているページで axe-core による監査を実行します。 |
NEXUS_A11Y_STANDARD | wcag21aa | 適用する規則: wcag2a、wcag2aa、wcag21a、wcag21aa、または wcag22aa。 |
NEXUS_A11Y_FAIL_LEVEL | serious | 違反とみなす影響度の下限: minor、moderate、serious、または critical。 |
NEXUS_A11Y_STRICT | false | true の場合、不合格とする影響度以上の違反があると、合格したテストに A11Y_VIOLATION の判定を付けます。 |
得点と判定の仕組み
A11Y_VIOLATION は 15 種類ある判定の 1 つです。合格したテストにのみ適用され、CI での終了コードは 0 のままで、レポートと履歴に留意事項が表示されます。不合格のテストの判定がさらに変更されることはなく、カオス実行では監査が省略されます。模擬環境か実機かを問わず、タッチ画面にはターゲットサイズの要件を追加した WCAG 2.2 AA による監査も行われます。
| Impact | 得点への重み付け |
|---|---|
| 致命的 | 違反した規則ごとに 25 点 |
| 重大 | 違反した規則ごとに 10 点 |
| 中程度 | 違反した規則ごとに 4 点 |
| 軽微 | 違反した規則ごとに 1 点 |
レポートに含まれる内容
得点と評価
得点は 100 から上記の重みを差し引いた値です。要素ごとではなく、違反した規則ごとに 1 回だけ計上します。評価は 90 点以上が A、75 点以上が B、60 点以上が C、40 点以上が D、それ未満が F です。これは 1 ページについて独自にまとめた評価であり、WCAG の適合レベルではありません。
違反が検出された規則
深刻なものから順に最大 15 件の規則を表示し、それぞれの影響度、WCAG タグ、規則のヘルプページへのリンク、最大 5 件の該当要素例を示します。この節は report.md に追加されます。
人による確認が必要な検査の件数
axe-core は、判断できない検査を未完了として扱います。レポートにはその件数が示され、人による確認が必要であることが記載されます。
自動検査では見つからない問題
自動検査で見つかるのは、ページのアクセシビリティの問題の一部に限られます。問題が検出されなくても、そのページが誰にでも利用しやすいとは限りません。また、Nexus StudioQA は WCAG への適合を認証するものではありません。
マークアップだけでなく意味も
規則によって、画像に代替テキストがあるかは確認できます。ただし、その文章が画像を適切に説明しているか、リンクの文言が文脈なしでも意味をなすかは判断できません。
キーボードやスクリーンリーダーでの利用
読み上げ順序が適切か、キーボードだけで、またはスクリーンリーダーを使ってページを利用できるかは、人が実際に試して確認する必要があります。
テストごとに検査できるのはページの 1 つの状態のみ
監査はテスト終了時に表示されているページで実行されます。テスト中に到達しなかったページや、終了前に閉じられた状態は監査されません。
よくある質問
自動テストは人によるアクセシビリティ監査の代わりになりますか?
いいえ。機械で判断できる規則の違反を検出し、それ以外は確認が必要な項目として一覧表示します。人による監査の代わりではなく、監査と次の監査の間に問題が再発するのを防ぐために使用してください。
アクセシビリティの問題があるとビルドは失敗しますか?
既定では失敗しません。問題はレポートに一覧表示されます。
NEXUS_A11Y_STRICT=trueを指定すると、合格したテストに不合格とする影響度以上の違反がある場合、A11Y_VIOLATION と表示されますが、CI での終了コードは 0 のままです。どのバージョンの WCAG に基づいてテストしますか?
既定はWCAG 2.1 AAです. 設定では2.0と2.1のレベルAおよびAA, ならびに2.2 AAを選択できます. タッチ画面では, WCAG 2.2 AAが追加されます.
既存のテストでも使えますか?
はい. Nexus StudioQAで実行するPlaywright, Selenium, pytestのテストのアサーションと並行して動作します. 実行時に
--a11yを指定するか, 設定ですべての実行に対して有効にします. アクセシビリティ設定