{"canonical_url":"https://engineer.company/ja/glossary/axe/","content_markdown":"# axe\n\n## どのようなものか\n\naxeは、オープンソースのJavaScriptライブラリーaxe-coreとして公開される、自動アクセシビリティルールの集合です。ウェブページ内で動き、ブラウザーの描画結果を調べ、違反する各要素を報告します。アクセシビリティ企業Deque Systemsが、Mozilla Public License 2.0で保守しています。他のツールも使っています。ChromeのLighthouseのアクセシビリティ評価はaxeの影響度で重み付けし、Playwrightの公式ガイドも、小さな補助パッケージでaxeを動かします。\n\nエンジンは一つのスクリプトです。テスト実行ツールやブラウザー拡張が対象ページへ読み込み、`axe.run`を呼びます。入れ子のフレームとシャドウDOMを含む文書を巡り、条件に合うすべてのルールを適用します。配置後のページを読むため、文章が見えるか、何色の上にあるか、要素が隠れているかなど、ソースだけでは分からないものを確認できます。そのため、一部のルールには実際のブラウザーが必要です。多くの単体テストで使う模擬文書JSDOMでは、色のコントラストのルールは動かないと、プロジェクトは述べています。\n\n各ルールにはタグがあります。`wcag2a`、`wcag2aa`、`wcag21aa`、`wcag22aa`などは、WCAGの版とレベルを示し、達成基準にないものは`best-practice`とします。他には、EN 301 549、Section 508、W3Cの適合性検査ルールとの対応を示すタグがあります。チームはタグで対象を決めます。\n\n結果は単純な合否ではなく、四つの一覧です。\n\n- `violations`：失敗した要素。影響度をminor（軽微）、moderate（中程度）、serious（深刻）、critical（致命的）で示し、短い修正方法と詳しい説明へのリンクを付けます。\n- `passes`：通った要素。ルールが実際に動いたことを確認できます。\n- `incomplete`：文書が「要確認」とも呼ぶ、確実に合否を決められず、人が見る必要のある要素です。\n- `inapplicable`：動画のないページの動画ルールなど、対象がなかったルールです。\n\n## なぜ重要なのか\n\naxeが支える判断は、アクセシビリティのどこを機械に任せ、失敗で公開を止めるかです。二つの性質が適しています。実行の負担が小さく、年一回の監査にとどまらず、ビルドごとに検査できます。また、制作者が掲げる目標は、不具合を除いて誤検出ゼロです。不確かなものは違反ではなく、要確認へ送ります。誤報ばかりの検査は無効にされますが、証明できるものだけなら、不満なくビルドを失敗させられます。\n\n限界は検査の範囲です。Dequeによると、axe-coreはWCAG上の問題の平均57パーセントを自動で発見し、判断が不確かな結果は人による確認に回します。この数値は発見される問題の割合であり、機械が評価できる達成基準の割合ではありません。\n\n届かないのは、主に判断です。画像に代替テキスト、ボタンに名前、入力欄にラベルがあることは確認できます。その言葉が画像を説明するか、名前が操作を示すか、順に音読して意味が通るかは分かりません。スクリーンリーダーとキーボードを使う人が必要で、機械が単純な検査で節約する時間を、そこに使えます。\n\nタグの選択自体にも、利点と不利益があります。WCAGタグだけなら、適合性の主張ときれいに対応しますが、それ以外は対象外です。best-practiceを加えると、どのランドマークにも入らない内容や、最上位の見出しがないページなど、WCAGが名指ししなくても利用者が直面する問題を捕まえます。代償は、適合性監査では挙げられない、いくつかの失敗です。\n\n## 実際の活用例\n\nこのサイトの二つのページが、エンジンに任せる範囲を示します。\n\nあるプラットフォームでは、四層のテストと並んで、[axe-coreの品質ゲートがWCAG 2.0・2.1のA・AA違反ゼロを検証します](/ja/portfolio/built-a-test-suite-across-go-sql-and-browser/)。数か月後の監査指摘ではなく、ビルド失敗にします。重要なのは時期です。変更がまだレビュー中のうちに、書いた本人が直せます。\n\nこのサイトの[クレジット](/ja/credits/)は、各言語の各テンプレート一ページずつを、両方の配色でWCAG 2.2 A・AAに照らして監査する、品質ゲートを説明しています。別のレポートではなく、ゲートの一部です。両配色を使うことで、暗い配色だけのコントラスト不良でも、ビルドを止められます。テンプレートごとの一ページが代表できるのは、同じテンプレートのページが構造を共有するためです。2026年10月には、38ページで2,268ページのサイトを代表できました。自動ルールではWCAGが求める判断をすべて行えないため、サイトは合格印ではなく、達成基準ごとに記録を持ちます。\n\n## 問題が起きるところ\n\n多くは信頼の失敗です。見かけより少ない範囲しか検査していなかったり、結果が示す以上の意味を読み取ったりすることです。\n\n**タグ一覧からルールが漏れます。** タグは累積ではありません。`wcag2aa`にはWCAG 2.0のAA基準だけがあり、単独ならAをすべて飛ばします。API文書も、`wcag2a`と`wcag2aa`の両方が必要と明言しています。同様に、`wcag21aa`は2.1で追加した基準だけで、WCAGタグだけでは`best-practice`は動きません。ルール一覧はWCAG 2.2を標準では無効としており、タグなしでも除外されます。指定すると有効になります。対象の全タグを挙げ、裏付ける主張の横に置きます。\n\n```js\nconst results = await axe.run(document, {\n    runOnly: {\n        type: \"tag\",\n        values: [\"wcag2a\", \"wcag2aa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\"],\n    },\n});\n```\n\n四つのどの一覧にもないルールは、そもそも動いていません。設定を変えるたび、一度は一覧を読みます。\n\n**指摘ゼロを、アクセシビリティに対応したページの証明と受け取ります。** 違反ゼロとは、動いたルールが失敗を証明できなかったという意味です。代替テキストの正しさ、適切なフォーカス順序、読み上げ利用者の作業完了については、何も言いません。最低限と捉え、できない検査の予定を設けます。\n\n**要確認の一覧を捨てます。** 違反だけで失敗するゲートは、`incomplete`を誰にも見せず通します。エンジンが見て決められなかった対象こそ、人を最も必要とします。読む人へ渡すか、それもビルド失敗にします。\n\n**一つの状態だけでテストします。** 検査するのは実行時の表示です。閉じたメニュー、開いていないダイアログ、誤入力後だけのエラー、もう一方の配色は、初期表示の検査に含まれません。重要な各状態へ操作し、それぞれで再実行します。\n\n**描画しない環境で動かします。** 模擬文書には配置も計算済みの色もなく、コントラストはそこで動かないと明記されています。単体テストでも構造の問題は捕まえますが、コントラストなどの視覚的な検査は、実ブラウザーで行います。\n\n**公開のためにルールを無効にします。** 一つの部品が失敗するため全体で無効にすると、後から書くページも含め、他の違反を隠します。代わりに、その要素だけを除外し、理由と、解除する時期を記載します。\n\n## 参考資料\n\n- [axe-core](https://github.com/dequelabs/axe-core)：エンジンのソース、掲げる原則、対応ブラウザーです。\n- [ルールの説明](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)：影響度とタグを、WCAGの版、推奨実践、AAA、実験的・非推奨の分類で示します。\n- [axe-core API](https://github.com/dequelabs/axe-core/blob/develop/doc/API.md)：タグ、`runOnly`、対象範囲の指定、四種類の結果の形です。\n- [アクセシビリティテスト](https://playwright.dev/docs/accessibility-testing)：操作後の検査も含む、Playwrightのブラウザーテストでaxeを使う方法です。\n\n\u003chttps://engineer.company/ja/glossary/axe/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"描画したページをaxeが検査する仕組み、四種類の結果の意味、指摘ゼロを合格の証明でなく最低限と考える理由を説明します","formats":{"gemtext":"https://engineer.company/ja/glossary/axe/index.gmi","gopher":"https://engineer.company/ja/glossary/axe/gophermap","html":"https://engineer.company/ja/glossary/axe/","json":"https://engineer.company/ja/glossary/axe/index.json","markdown":"https://engineer.company/ja/glossary/axe/index.md","pdf":"https://engineer.company/ja/glossary/axe/index.pdf"},"kind":"page","language":"ja","title":"axeとは？","url":"https://engineer.company/ja/glossary/axe/","version":1}