axe

どのようなものか

axeは、オープンソースのJavaScriptライブラリーaxe-coreとして公開され
る、自動アクセシビリティルールの集合です。ウェブページ内で動き、ブラ
ウザーの描画結果を調べ、違反する各要素を報告します。アクセシビリティ
企業Deque
Systemsが、Mozilla Public License
2.0で保守しています。他のツールも使っています。ChromeのLighthouseの
アクセシビリティ評価はaxeの影響度で重み付けし、Playwrightの公式ガイ
ドも、小さな補助パッケージでaxeを動かします。

エンジンは一つのスクリプトです。テスト実行ツールやブラウザー拡張が対
象ページへ読み込み、`axe.run`を呼びます。入れ子のフレームとシャドウ
DOMを含む文書を巡り、条件に合うすべてのルールを適用します。配置後の
ページを読むため、文章が見えるか、何色の上にあるか、要素が隠れている
かなど、ソースだけでは分からないものを確認できます。そのため、一部の
ルールには実際のブラウザーが必要です。多くの単体テストで使う模擬文書
JSDOMでは、色のコントラストのルールは動かないと、プロジェクトは述べ
ています。

各ルールにはタグがあります。`wcag2a`、`wcag2aa`、`wcag21aa`、
`wcag22aa`などは、WCAGの版とレベルを示し、達成基準にないものは
`best-practice`とします。他には、EN
301 549、Section 508、W3Cの適合性検査ルールとの対応を示すタグがあり
ます。チームはタグで対象を決めます。

結果は単純な合否ではなく、四つの一覧です。

  *
`violations`：失敗した要素。影響度をminor（軽微）、moderate（中程
度）、serious（深刻）、critical（致命的）で示し、短い修正方法と詳し
い説明へのリンクを付けます。

  * `passes`：通った要素。ルールが実際に動いたことを確認できます。

  * `incomplete`：文書が「要確認」とも呼ぶ、確実に合否を決められず、
人が見る必要のある要素です。

  * `inapplicable`：動画のないページの動画ルールなど、対象がなかった
ルールです。

なぜ重要なのか

axeが支える判断は、アクセシビリティのどこを機械に任せ、失敗で公開を
止めるかです。二つの性質が適しています。実行の負担が小さく、年一回の
監査にとどまらず、ビルドごとに検査できます。また、制作者が掲げる目標
は、不具合を除いて誤検出ゼロです。不確かなものは違反ではなく、要確認
へ送ります。誤報ばかりの検査は無効にされますが、証明できるものだけな
ら、不満なくビルドを失敗させられます。

限界は検査の範囲です。Dequeによると、axe-coreはWCAG上の問題の平均57
パーセントを自動で発見し、判断が不確かな結果は人による確認に回しま
す。この数値は発見される問題の割合であり、機械が評価できる達成基準の
割合ではありません。

届かないのは、主に判断です。画像に代替テキスト、ボタンに名前、入力欄
にラベルがあることは確認できます。その言葉が画像を説明するか、名前が
操作を示すか、順に音読して意味が通るかは分かりません。スクリーンリー
ダーとキーボードを使う人が必要で、機械が単純な検査で節約する時間を、
そこに使えます。

タグの選択自体にも、利点と不利益があります。WCAGタグだけなら、適合性
の主張ときれいに対応しますが、それ以外は対象外です。best-practiceを
加えると、どのランドマークにも入らない内容や、最上位の見出しがない
ページなど、WCAGが名指ししなくても利用者が直面する問題を捕まえます。
代償は、適合性監査では挙げられない、いくつかの失敗です。

実際の活用例

このサイトの二つのページが、エンジンに任せる範囲を示します。

あるプラットフォームでは、四層のテストと並んで、axe-coreの品質ゲート
がWCAG
2.0・2.1のA・AA違反ゼロを検証します。数か月後の監査指摘ではなく、ビ
ルド失敗にします。重要なのは時期です。変更がまだレビュー中のうちに、
書いた本人が直せます。

このサイトのクレジットは、各言語の各テンプレート一ページずつを、両方
の配色でWCAG 2.2
A・AAに照らして監査する、品質ゲートを説明しています。別のレポートで
はなく、ゲートの一部です。両配色を使うことで、暗い配色だけのコントラ
スト不良でも、ビルドを止められます。テンプレートごとの一ページが代表
できるのは、同じテンプレートのページが構造を共有するためです。2026年
10月には、38ページで2,268ページのサイトを代表できました。自動ルール
ではWCAGが求める判断をすべて行えないため、サイトは合格印ではなく、達
成基準ごとに記録を持ちます。

問題が起きるところ

多くは信頼の失敗です。見かけより少ない範囲しか検査していなかったり、
結果が示す以上の意味を読み取ったりすることです。

タグ一覧からルールが漏れます。 タグは累積ではありません。`wcag2aa`に
はWCAG
2.0のAA基準だけがあり、単独ならAをすべて飛ばします。API文書も、
`wcag2a`と`wcag2aa`の両方が必要と明言しています。同様に、`wcag21aa`
は2.1で追加した基準だけで、WCAGタグだけでは`best-practice`は動きませ
ん。ルール一覧はWCAG
2.2を標準では無効としており、タグなしでも除外されます。指定すると有
効になります。対象の全タグを挙げ、裏付ける主張の横に置きます。

```js
const results = await axe.run(document, {
    runOnly: {
        type: "tag",
        values: ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa"],
    },
});
```

四つのどの一覧にもないルールは、そもそも動いていません。設定を変える
たび、一度は一覧を読みます。

指摘ゼロを、アクセシビリティに対応したページの証明と受け取ります。
違反ゼロとは、動いたルールが失敗を証明できなかったという意味です。代
替テキストの正しさ、適切なフォーカス順序、読み上げ利用者の作業完了に
ついては、何も言いません。最低限と捉え、できない検査の予定を設けま
す。

要確認の一覧を捨てます。
違反だけで失敗するゲートは、`incomplete`を誰にも見せず通します。エン
ジンが見て決められなかった対象こそ、人を最も必要とします。読む人へ渡
すか、それもビルド失敗にします。

一つの状態だけでテストします。
検査するのは実行時の表示です。閉じたメニュー、開いていないダイアロ
グ、誤入力後だけのエラー、もう一方の配色は、初期表示の検査に含まれま
せん。重要な各状態へ操作し、それぞれで再実行します。

描画しない環境で動かします。
模擬文書には配置も計算済みの色もなく、コントラストはそこで動かないと
明記されています。単体テストでも構造の問題は捕まえますが、コントラス
トなどの視覚的な検査は、実ブラウザーで行います。

公開のためにルールを無効にします。
一つの部品が失敗するため全体で無効にすると、後から書くページも含め、
他の違反を隠します。代わりに、その要素だけを除外し、理由と、解除する
時期を記載します。

参考資料

  * axe-core：エンジンのソース、掲げる原則、対応ブラウザーです。

  * ルールの説明：影響度とタグを、WCAGの版、推奨実践、AAA、実験的・
非推奨の分類で示します。

  * axe-core API：タグ、`runOnly`、対象範囲の指定、四種類の結果の形
です。

  * アクセシビリティテスト：操作後の検査も含む、Playwrightのブラウ
ザーテストでaxeを使う方法です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/axe/	engineer.company	70
