Перейти до основного вмісту
Доступність та стандарти
9 хв читання

Автоматизоване тестування доступності в CI/CD: побудова пайплайну з Axe-Core, Playwright та GitHub Actions

Глибокий інженерний посібник з інтеграції автоматизованого тестування доступності в CI/CD пайплайни за допомогою @axe-core/playwright, кастомних правил, матриці контрастності для світлої/темної тем та автоматичних PR quality gates за стандартами WCAG 2.2 AA.

AY
Artur Yusupov
Fullstack веб-інженер та AI-розробник
Автоматизоване тестування доступності в CI/CD: побудова пайплайну з Axe-Core, Playwright та GitHub Actions

1. Чому ручні аудити доступності запізнюються

У сучасних командах розробки доступність часто розглядається як формальність - її залишають на щорічний ручний аудит перед релізом чи регуляторним дедлайном.

Така модель неефективна:

  • Висока вартість виправлень: Усунення недоступного модального вікна, порушеної ієрархії заголовків чи відсутності фокусу після деплою в продакшн коштує в 10 разів більше годин розробки, ніж виправлення на етапі pull request.
  • Постійні регресії: Понад 57% порушень WCAG у продакшні з являються внаслідок звичайних оновлень CSS або бібліотек компонентів, які випадково ламають контраст чи фокусні кільця.

Сучасне інженерне рішення - це DevSecOps для доступності: перенесення перевірок у повністю автоматизований пайплайн CI/CD за допомогою Axe-Core та Playwright.

Матриця методів тестування доступності: ручний аудит vs Lighthouse vs Playwright + Axe-Core

Підхід до тестування доступності
Ручний аудит скрінрідером
Охоплення правил WCAG 2.2
100% (Включає людський смисловий контекст)
Інтеграція в CI/CD
Неможливо в автоматичному PR-пайплайні
Швидкість виконання
Дні або тижні
Рівень хибних спрацьовувань
Високий (Суб'єктивність аудитора)
Підхід до тестування доступності
Lighthouse CI (Базовий)
Охоплення правил WCAG 2.2
~25% - 30% порушень
Інтеграція в CI/CD
Просте налаштування в GitHub Actions
Швидкість виконання
15 - 30 секунд
Рівень хибних спрацьовувань
Середній (Загальні попередження)
Підхід до тестування доступності
Playwright + Axe-Core (Рекомендований)
Охоплення правил WCAG 2.2
~55% - 60% (Усі структурні та контрастні дефекти)
Інтеграція в CI/CD
Блокуючий PR-гейт із SARIF-звітами
Швидкість виконання
< 3 секунд на сторінку
Рівень хибних спрацьовувань
0% (Детерміновані перевірки DOM)

2. Архітектурна схема автоматизованого пайплайну

Пайплайн працює на трьох рівнях зворотного зв язку:

CODE
┌──────────────────┐      ┌─────────────────────────┐      ┌──────────────────────────┐
│ Контур розробки  │ ───> │    Шлюз Pull Request    │ ───> │     Деплой у прод        │
│ Pre-commit хук   │      │   GitHub Actions CI     │      │  Постійний моніторинг    │
│ (Vitest / A11y)  │      │  Playwright + Axe-Core  │      │   SARIF / Lighthouse     │
└──────────────────┘      └─────────────────────────┘      └──────────────────────────┘
1
Pre-commit: Швидкі юніт-перевірки компонентів на базі axe-core у локальному середовищі.
2
Pull Request (CI): Повне end-to-end тестування у безголових браузерах через @axe-core/playwright на реальному дереві DOM із динамічними станами.
3
Quality Gate: Автоматичні анотації в PR і блокування злиття коду у разі виявлення критичних помилок.

3. Налаштування @axe-core/playwright

Встановлення офіційної бібліотеки інтеграції:

BASH
pnpm add -D @axe-core/playwright @playwright/test

Утиліта для запуску комплексного аудиту з детальним діагностичним звітом:

TYPESCRIPT
// e2e/utils/a11y-audit.ts
import { Page, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

export async function checkA11y(page: Page) {
  const results = await new AxeBuilder({ page })
    .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'])
    .exclude('#clarity-script')
    .analyze();

  if (results.violations.length > 0) {
    const errorReport = results.violations.map((v) => {
      const nodes = v.nodes.map((n) => `  - ${n.target.join(' ')}: ${n.failureSummary}`).join('\n');
      return `[A11y Violation] ${v.id}: ${v.description}\n${nodes}`;
    }).join('\n\n');

    expect(results.violations, errorReport).toEqual([]);
  }
}

4. Тестування модальних вікон та матриці контрастності

А. Аудит модальних вікон та утримання фокусу

Коли модальне вікно відкрито, фокус повинен залишатися всередині, а фон блокуватися:

TYPESCRIPT
test('модальне вікно відповідає стандарту WCAG 2.2 AA', async ({ page }) => {
  await page.goto('/ua/projects');
  await page.locator('button[data-project-slug="unitrition"]').click();

  const dialog = page.locator('div[role="dialog"]');
  await expect(dialog).toBeVisible();

  await checkA11y(page);

  await page.keyboard.press('Escape');
  await expect(dialog).toBeHidden();
});

Б. Матриця тем (темна та світла теми)

Контрастність тексту часто проходить у темній темі, але падає нижче 4.5:1 при переході на світлу тему. Тести автоматично перемикають тему і перевіряють контраст обох варіантів.


5. Конфігурація GitHub Actions Quality Gate

Файл .github/workflows/a11y-ci.yml запускає тести Playwright на кожному коміті та PR, повертаючи Exit Code 1 при виявленні будь-якого порушення доступності. Це унеможливлює випадкове потрапляння невідповідного коду в продакшн.


6. Результат: 100% гарантія відсутності регресій

  • Автоматичний перехват 40%-50% дефектів доступності ще до ручного код-рев ю.
  • Швидкість виконання - менше 3.5 секунд на весь набір тестів.
  • Повний документальний аудит-трейл для підтвердження відповідності вимогам European Accessibility Act 2026.
Практичне впровадження в коді

Де ця архітектура працює у моєму портфоліо

Ці інженерні рішення не є абстрактною теорією - вони повністю реалізовані та перевірені у наступних робочих продуктах:

Архітектурний аудит

Плануєте міграцію стеку або розробку продукту?

Обговоріть архітектурні вимоги вашого проєкту з інтерактивним RAG AI-асистентом або зв’яжіться напряму для інженерної оцінки.

Написати напряму