SVG Title Coverage Checker

Classify the SVG instances in an exported HTML document as meaningful or decorative, and check the accessible-name sources the meaningful ones carry: aria-labelledby, aria-label and a title element, plus description links and id uniqueness.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

# a document whose graphics are all classified and named
node bin/svg-title-coverage-checker.mjs \
  --html examples/clean/page.html \
  --policy examples/clean/svg.policy.json \
  --now 2026-09-18
# exit 0

# a meaningful graphic with no name source, and a decorative one that carries one
node bin/svg-title-coverage-checker.mjs \
  --html examples/broken/page.html \
  --policy examples/broken/svg.policy.json \
  --now 2026-09-18
# exit 1

# a graphic inside a declarative shadow root
node bin/svg-title-coverage-checker.mjs \
  --html examples/shadow-root/page.html \
  --policy examples/shadow-root/svg.policy.json \
  --now 2026-09-18
# exit 2 -- incomplete, not clean

Read the result

--now is required and there is no default: this tool reads no clock of its own. It is the instant used for the expiry of a manual classification, so the same documents always produce the same verdict, and a run that omits it is a configuration error (exit 2, empty stdout).

Scope

Exceeding a limit is an incomplete result with a finding naming the limit. Nothing is silently truncated and nothing is a pass.