Skip to main content

Module ui

Module ui 

Source
Expand description

The UI conformance report: what a browser found on every page of the built site.

The evidence is the results document scripts/ui audit writes — the pages it visited, the widths it visited them at, and every finding, each already naming the rule it broke and the elements that broke it. This module parses and renders it. It decides nothing: a page is conformant here exactly when the audit found nothing on it, and a report that disagreed with the audit would be worse than no report.

The rendering is a section of the test surface rather than a surface of its own. A UI conformance run is a test run, /tests/ui is where a reader looks for it, and the topology refuses a surface mounted inside another’s subtree (surface.nested-mount), so the architecture has already answered where this belongs.

Structs§

Element
One element a finding names, as the browser saw it.
Finding
One thing wrong on one page at one width.
Foreign
A subtree of a page the engine was told to skip, and what declared it.
Run
A whole audit run.
Surface
One surface the audit measured, and what it contributed.

Constants§

RESULTS_SCHEMA
The contract of the results document, written by scripts/lib/ui-run.mjs.
SECTION
The directory of this report inside the test surface, and the path it is read at.

Functions§

parse
Read a results document, refusing a contract this executable does not know.
read
Read a results document from disk.
render
Render the run into /tests/ui, inside the test surface.