{"canonical_url":"https://engineer.company/uk/glossary/axe/","content_markdown":"# axe\n\n## Що це таке\n\naxe, що виходить як бібліотека JavaScript із відкритим кодом під назвою axe-core, — це набір\nавтоматичних правил доступності, який працює всередині вебсторінки, перевіряє те, що відмалював\nбраузер, і повідомляє про кожен елемент, що порушує одне з цих правил. Підтримує його компанія Deque\nSystems, яка займається доступністю, за ліцензією Mozilla Public License 2.0. На ньому будують інші\nінструменти: категорія доступності в Lighthouse від Chrome зважує свої аудити за оцінками впливу з\naxe, а власний посібник Playwright із тестування доступності запускає axe через невеликий супутній\nпакет.\n\nРушій — це один скрипт. Тестовий раннер або розширення браузера завантажує його в сторінку, яку\nперевіряють, і викликає `axe.run`, а рушій обходить документ, зокрема вкладені фрейми й shadow DOM,\nі застосовує кожне правило, умови якого виконано. Оскільки він читає сторінку вже після того, як\nбраузер розташував її елементи, він може перевірити те, чого не видно з самого коду: чи текст видимий, на якому\nкольорі він стоїть, чи прихований елемент. З тієї ж причини деяким правилам потрібен справжній\nбраузер. Проєкт прямо пише, що його правило контрасту кольорів не працює в JSDOM, імітованому\nдокументі, яким користується багато налаштувань для модульних тестів.\n\nКожне правило має теги. Один із них каже, до якої версії й рівня WCAG належить правило, наприклад\n`wcag2a`, `wcag2aa`, `wcag21aa` чи `wcag22aa`, або позначає його як `best-practice`, коли жоден\nкритерій успіху його не вимагає. Інші теги пов'язують правила з EN 301 549, Section 508 або\nправилами W3C для тестування відповідності. Саме тегами команда визначає, що перевіряє прогін.\n\nПовертається не одне «пройдено» чи «не пройдено», а чотири списки:\n\n- `violations`: елементи, що порушили правило, кожен з оцінкою впливу (minor, moderate, serious або\n  critical), коротким описом виправлення й посиланням на докладніше пояснення.\n- `passes`: елементи, що пройшли перевірку; саме з них команда бачить, що правило справді\n  спрацювало.\n- `incomplete`, які документація також називає «needs review»: елементи, які рушій не може з\n  певністю ні зарахувати, ні відхилити, тож на них має подивитися людина.\n- `inapplicable`: правила, яким не було чого перевіряти, як-от правила для відео на сторінці без\n  відео.\n\n## Чому це важливо\n\nРішення, якому служить axe, стосується того, які частини доступності команда передає машині і чи має\nзбій зупиняти випуск. Дві властивості роблять рушій придатним для цього. Він дешевий у запуску, тож\nможе перевіряти кожну збірку, а не один аудит на рік. І заявлена мета його авторів — нуль хибних\nспрацювань, якщо не рахувати помилок у самому рушії: усе, в чому рушій не впевнений, іде до списку\nна перегляд, а не до списку порушень. Перевірку, яка даремно кричить «вовк», вимикають; ту, що\nповідомляє лише доведене, можна зробити підставою для падіння збірки, і ніхто на неї не\nображатиметься.\n\nОбмеження полягає в охопленні. Deque пише, що axe-core у середньому автоматично знаходить\n57% проблем WCAG, а непевні результати передає на ручний розгляд. Це число описує виявлені\nпроблеми, а не частку критеріїв успіху, які машина може оцінити.\n\nПоза досяжністю лишається передусім судження. axe може підтвердити, що зображення має альтернативний\nтекст, кнопка має ім'я, а поле форми — мітку. Він не може сказати, чи текст описує зображення, чи\nім'я каже, що робить кнопка, і чи сторінка має сенс, коли її читають уголос по порядку. Для цих\nпитань потрібна людина з екранним читачем і клавіатурою, а час, який машина заощаджує на механічних\nперевірках, ця людина може витратити на них.\n\nВибір тегів — окремий компроміс. Прогін лише правил із тегами WCAG дає результат, який чітко лягає\nна заяву про відповідність, і ні на що інше. Додавши правила best-practice, команда ловить проблеми,\nяких WCAG не називає, але з якими користувачі все одно стикаються, як-от вміст поза всіма\nорієнтирами чи сторінка без заголовка верхнього рівня. Ціна — кілька збоїв, на які аудит\nвідповідності ніколи б не послався.\n\n## Як це виглядає на практиці\n\nДві сторінки цього сайту показують, що саме довіряють рушієві.\n\nУ тестовому наборі однієї платформи він стоїть поряд із чотирма рівнями тестів, і\n[гейт на axe-core вимагає нуля порушень WCAG 2.0 і 2.1 рівнів A та AA](/uk/portfolio/built-a-test-suite-across-go-sql-and-browser/),\nтож доступність стає падінням збірки, а не знахідкою аудиту через кілька місяців. Суть у часі:\nдефект, через який падає збірка, виправляють одразу, поки щойно написана зміна ще відкрита.\n\nНа цьому сайті [сторінка подяк](/uk/credits/) описує, як рушій перевіряє добірку репрезентативних\nсторінок, по одній на кожен шаблон кожною мовою, на відповідність WCAG 2.2 рівнів A та AA в обох\nколірних темах, і робить це в межах обов'язкових перевірок, а не окремим звітом осторонь. Прогін в\nобох темах означає, що збій контрасту, який з'являється лише в темній темі, однаково може зупинити\nзбірку. Вибірка по одній сторінці на шаблон спирається на те, що сторінки з одного шаблону мають\nоднакову структуру, і саме це в жовтні 2026 року дало змогу 38 сторінкам представляти сайт на 2 268\nсторінок. Автоматичні правила не охоплюють усіх оцінок, яких потребує WCAG, тому сайт веде свій\nзвіт окремо за кожним критерієм успіху, а не як єдину позначку «пройдено».\n\n## Де виникають проблеми\n\nБільшість збоїв з axe — це збої довіри: прогін, що перевірив менше, ніж здавалося, або результат,\nякий прочитали як більше, ніж він каже.\n\n**Список тегів пропускає правила.** Теги не накопичуються. `wcag2aa` містить лише правила для\nкритеріїв рівня AA з WCAG 2.0, тож прогін, обмежений ним, пропускає всі правила рівня A, і\nдокументація API прямо каже, що потрібні обидва теги, `wcag2a` і `wcag2aa`. Так само `wcag21aa`\nмістить лише правила для критеріїв, які додала версія 2.1, а прогін, обмежений тегами WCAG, ніколи\nне виконує правил `best-practice`. В описах правил правила WCAG 2.2 позначено як вимкнені за\nзамовчуванням, тож прогін без тегів їх пропускає; якщо назвати їхній тег, вони вмикаються. Називайте\nкожен тег, який має покрити прогін, і тримайте список поруч із твердженням, яке він підтримує:\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запускалися, не довели жодного збою. Це нічого не каже про те, чи правильний альтернативний текст,\nчи фокус переміщується в розумному порядку і чи людина з екранним читачем зможе виконати завдання.\nСприймайте прогін як мінімум і плануйте перевірки, яких він зробити не може.\n\n**Список на перегляд викидають.** Гейт, що падає лише на порушеннях, пропускає результати\n`incomplete`, і їх ніхто не бачить. Це елементи, які рушій розглянув і залишив без рішення, а отже\nсаме вони найбільше потребують людини. Передавайте їх людині, яка їх прочитає, або нехай збірка\nпадає й на них.\n\n**Сторінку перевіряють в одному стані.** Рушій перевіряє те, що відмальовано в момент запуску.\nЗакрите меню, діалог, який ще ніхто не відкривав, повідомлення про помилку, що з'являється лише\nпісля невдалого надсилання, та інша колірна тема — усе це лишається поза прогоном сторінки в тому\nвигляді, в якому вона щойно завантажилася. Доводьте сторінку до кожного стану, що має значення, і\nзапускайте рушій знову в кожному з них.\n\n**Рушій працює там, де нічого не малюється.** Імітований документ не має ні геометрії елементів, ні обчислених\nкольорів, і проєкт називає контраст правилом, яке там не працює. Модульні тести з axe однаково\nловлять структурні проблеми; контраст і все інше візуальне належить справжньому браузеру.\n\n**Правило вимикають, щоб випустити реліз.** Вимкнення правила для всього прогону через один\nкомпонент приховує його збої всюди, зокрема на сторінках, які напишуть пізніше. Натомість виключайте\nз перевірки один елемент і залишайте примітку, чому й коли цей виняток слід прибрати.\n\n## Що почитати далі\n\n- [axe-core](https://github.com/dequelabs/axe-core) — вихідний код рушія, його заявлені принципи й\n  список підтримуваних браузерів.\n- [Rule Descriptions](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) —\n  кожне правило з його впливом і тегами, згруповані за версією WCAG, best practice, AAA,\n  експериментальними й застарілими правилами.\n- [axe-core API](https://github.com/dequelabs/axe-core/blob/develop/doc/API.md) — теги, параметр\n  `runOnly`, як включити чи виключити частини сторінки та будова чотирьох списків результатів.\n- [Accessibility testing](https://playwright.dev/docs/accessibility-testing) — посібник Playwright\n  про запуск axe у браузерних тестах, зокрема про перевірку сторінки після взаємодії з нею.\n\n\u003chttps://engineer.company/uk/glossary/axe/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як рушій правил axe перевіряє відмальовану сторінку, що означають його чотири списки результатів і чому чистий прогін — це мінімум, а не остаточний висновок.","formats":{"gemtext":"https://engineer.company/uk/glossary/axe/index.gmi","gopher":"https://engineer.company/uk/glossary/axe/gophermap","html":"https://engineer.company/uk/glossary/axe/","json":"https://engineer.company/uk/glossary/axe/index.json","markdown":"https://engineer.company/uk/glossary/axe/index.md","pdf":"https://engineer.company/uk/glossary/axe/index.pdf"},"kind":"page","language":"uk","title":"Що таке axe?","url":"https://engineer.company/uk/glossary/axe/","version":1}