Open source · Accessibility

SVG Title Coverage Checker

Check title and description coverage for meaningful SVGs in rendered markup.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

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+; inspect the source before using it on your own files.

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).

Where this check stops

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

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.