접근성 테스트 자동화 axe-core와 WCAG 활용.
Nexus StudioQA의 접근성 테스트 자동화는 테스트 종료 시 실제 페이지에서 axe-core를 실행하고, 위반이 감지된 각 WCAG 규칙과 그 영향도, 관련 요소를 나열합니다. 기본적으로는 참고용입니다. 엄격 모드에서는 테스트를 통과했더라도 심각 이상의 위반이 있으면 A11Y_VIOLATION으로 표시합니다. 자동 검사는 접근성 문제 중 일부만 찾아내므로 수동 검토를 대체하지 못합니다.
작성: Verdict System LLC의 Nexus StudioQA 팀.
최종 업데이트: .
검사 항목과 활성화 방법
검사는 직접 활성화하기 전까지 꺼져 있습니다: 한 번만 실행하려면 --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가지 판정 중 하나입니다. 통과한 테스트에만 적용되며, CI에서는 종료 코드 0을 반환하고 보고서와 기록에 주의 사항이 표시됩니다. 실패한 테스트의 판정은 변경하지 않으며, 카오스 실행에서는 점검을 건너뜁니다. 에뮬레이션된 터치스크린과 실제 터치스크린 모두 대상 크기 기준이 추가된 WCAG 2.2 AA로도 점검합니다.
| Impact | 점수 가중치 |
|---|---|
| 치명적 | 위반한 규칙당 25점 |
| 심각 | 위반한 규칙당 10점 |
| 보통 | 위반한 규칙당 4점 |
| 경미 | 위반한 규칙당 1점 |
보고서에 포함되는 내용
점수와 등급
점수는 100점에서 위 가중치를 차감한 값으로, 요소별이 아닌 위반한 규칙별로 한 번씩 계산합니다. 등급은 90점 이상 A, 75점 이상 B, 60점 이상 C, 40점 이상 D이며, 그 미만은 F입니다. 이는 한 페이지에 대한 자체 요약 지표이며, WCAG 적합성 수준이 아닙니다.
위반이 감지된 규칙
가장 심각한 규칙부터 최대 15개를 표시하며, 각 규칙의 영향도, WCAG 태그, 해당 규칙의 도움말 페이지 링크와 최대 5개의 예시 요소를 제공합니다. 이 섹션은 report.md에 추가됩니다.
사람의 검토가 필요한 검사 수
axe-core는 판단할 수 없는 검사를 미완료로 표시합니다. 보고서에서는 이러한 검사의 수를 집계하고 사람의 검토가 필요하다고 안내합니다.
자동 검사로 찾아내지 못하는 문제
자동 검사는 페이지의 접근성 문제 중 일부만 찾아냅니다. 문제가 발견되지 않았다고 해서 해당 페이지의 접근성이 보장되는 것은 아니며, Nexus StudioQA는 WCAG 적합성을 인증하지 않습니다.
마크업뿐 아니라 의미까지
규칙을 통해 이미지에 대체 텍스트가 있는지는 확인할 수 있습니다. 하지만 그 텍스트가 이미지를 제대로 설명하는지, 링크 문구가 문맥 없이도 이해되는지는 판단할 수 없습니다.
키보드 또는 화면 낭독기로 사용
읽기 순서가 적절한지, 키보드만으로 또는 화면 낭독기로 페이지를 사용할 수 있는지는 사람이 직접 확인해야 합니다.
테스트당 하나의 페이지 상태만 검사
점검은 테스트가 종료된 페이지에서 실행됩니다. 테스트가 도달하지 않은 페이지나 종료 전에 닫힌 상태는 점검하지 않습니다.
자주 묻는 질문
자동 테스트가 수동 접근성 점검을 대체하나요?
아니요. 기계가 판단할 수 있는 규칙의 위반을 찾아내고 나머지는 검토가 필요한 항목으로 나열합니다. 수동 점검을 대체하는 대신, 수동 점검 사이에 문제가 재발하는 것을 방지하는 용도로 사용하세요.
접근성 문제가 있으면 빌드가 실패하나요?
기본적으로는 실패하지 않습니다. 문제는 보고서에 나열됩니다.
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를 지정하거나 모든 실행에 적용되도록 설정을 켜면 됩니다. 접근성 설정