Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Scanner does not wait for client-side rendering before running axe scan

Đang mở
  • Có gì không ổn?
#201 2 bình luận 2 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
58/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
playwright, react, typescript
Lĩnh vực
accessibility, frontend, testing-qa

Hướng nghiên cứu

Bắt đầu trong .github/actions/find/src/findForUrl.ts và kiểm tra chuỗi từ page.goto(url) đến AxeBuilder.analyze(). Tái hiện quá trình quét trên một trang React được render phía client và xác minh rằng axe quan sát DOM đã được render thay vì phần tử root ban đầu; được xem là hoàn thành khi các phát hiện được báo cáo và thời điểm quét khớp với trang đã được render hoàn chỉnh.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Problem

When scanning single-page applications (React, Vue, Angular, etc.), the scanner runs the axe scan immediately after page.goto() resolves (which waits for the load event). At that point, the JavaScript bundles are loaded but the framework hasn't finished rendering the DOM yet. This means axe scans a nearly-empty <div id="root"> instead of the actual page content.

This leads to:

  • False positives: Document-level violations like landmark-one-main and page-has-heading-one are reported because the landmarks and headings haven't been rendered yet.
  • False negatives: Element-level violations like button-name are missed because the elements don't exist in the DOM yet.
  • Misleading screenshots: Screenshots are taken after axe runs (inside addFinding), by which time React has finished rendering. So the screenshots show the correct, fully-rendered page — even though axe scanned a different DOM state.

Steps to reproduce

  1. Set up the scanner against any React/SPA application
  2. Run a scan on a page that has proper <main> landmarks and <h1> headings rendered by the framework
  3. Observe that landmark-one-main and page-has-heading-one violations are reported
  4. Run axe dev tools manually in the browser on the same page — these violations are not found
  5. Observe that element-level violations found by axe dev tools (e.g. button-name) are not reported by the scanner

Root cause

In findForUrl.ts:

await page.goto(url)
// axe runs immediately — no wait for client-side rendering
const rawFindings = await new AxeBuilder({page}).analyze()

page.goto() resolves on the load event, which fires when HTML/CSS/JS resources are loaded — but before the JS framework has executed and rendered the DOM.

Suggested fix

Add a wait for the page to be idle before running the axe scan. For example:

await page.goto(url)
await page.waitForLoadState('networkidle')
// or: await page.waitForTimeout(2000)
// or: await page.waitForFunction(() => document.querySelector('[data-testid]') !== null)
const rawFindings = await new AxeBuilder({page}).analyze()

waitForLoadState('networkidle') waits until there are no network connections for at least 500ms, which is a reasonable heuristic for "the SPA has finished its initial API calls and rendered."

Environment

  • github/accessibility-scanner@v2 (SHA: 7866232dda98e447fed8ec0d7798b322d888fd27)
  • React 19 application with Mantine UI, served from Docker containers via Caddy
  • Authenticated via auth_context input with session cookies
Ngôn ngữ chính
TypeScript
Star
374
Fork
42
Merge trung bình
1 ngày 13 giờ
Pull request đã merge (30 ngày)
7

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/accessibility-scanner

Tất cả issue của github/accessibility-scanner

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.