perf/html-weight
HTML document stays under 100 KB. Reglen perf/html-weight kører i page-scope med severity 'warning' og indgår i performance-domænet sammen med 7 andre kontrakter i frameworket.
Hvorfor html-weight findes
A Lighthouse score of 100 can hide a heavy page; a hard byte budget cannot. The HTML document itself should stay under 100 KB — beyond that, the cause is usually inlined data, oversized inline SVGs, or markup generated per-row instead of summarized.
Sådan håndhæves html-weight
Reglen html-weight evalueres på hver enkelt renderet HTML-side for sig, så et fund altid kan føres tilbage til én konkret side og én konkret rettelse i data eller template. Fejler en side, får agenten en finding, hvor fix-instruktionen for html-weight er formuleret som en konkret arbejdsordre med filnavne og målbare krav — aldrig et vagt råd. Severity 'warning' betyder at et brud på html-weight rapporteres uden at blokere builds — men guld-standarden er først nået, når også advarslerne er væk.
Domænet: performance
Perf-domænet internaliserer de statisk afgørbare dele af Lighthouse: billedformater og -vægt, render-blokerende ressourcer, dimensioner mod layout shift og selvhostede fonte. Målet er ikke en score men disciplin — siden er hurtig, fordi den ikke kan bygges langsom. Netop derfor hører html-weight hjemme her: kravet kan afgøres maskinelt, og dermed kan det håndhæves i stedet for blot at blive anbefalet.
Test og fixtures
Som alle kontrakter i frameworket har perf/html-weight en mutant-test, der beviser at reglen fejler, når kravet brydes — en regel uden en fejlende test er ikke en regel. Golden-fixturet beviser omvendt, at en fuldt compliant side består html-weight sammen med de øvrige 85 regler, og denne demoside er selv underlagt hele kontrakten.
Relaterede regler
Tilbage til oversigten over alle 86 regler.