CKTIS / HTML
blocking: weergave uitstellen voor een bron
Onderscheid het blokkeren van rendering van HTML-parsing en de uitvoeringsvolgorde van scripts.
Versie: HTML Living Standard
Syntax
<script async blocking="render" src="/gate.js"></script>Het attribuut blocking is een door spaties gescheiden tokenlijst op daarvoor bedoelde script-, stylesheetlink- en style-elementen. Het momenteel gedefinieerde token render vraagt rendering te wachten zolang de bron blokkeert. Plaatsing en de verwerkingsregels van elk element doen ertoe; een script dat de eerste weergave moet blokkeren hoort in de documentkop. Dit is een prestatiekeuze, geen beveiligingsbeperking voor code.
Rendering blokkeren is iets anders dan de parser blokkeren. Een extern script met async kan worden opgehaald zonder HTML-parsing te stoppen en tegelijk afzonderlijk de eerste weergave vertragen. Het attribuut bepaalt geen afhankelijkheidsvolgorde tussen onafhankelijke scripts. Het overal toevoegen kan de pagina langer blanco laten; reserveer het voor bronnen die werkelijk klaar moeten zijn voordat iets wordt getoond.
De lokale testopstelling houdt het externe script bewust vast totdat het DOM volledig is geparst. Het script ziet vervolgens dat er nog geen paintregistraties zijn en levert het resultaat. De test bevestigt ook dat na vrijgave een eerste paint met inhoud plaatsvindt. Hij controleert dit afgebakende geval in Chromium 145, geen tijdsgaranties voor ieder netwerk of iedere browser.
Voorbeelden
<!doctype html><html><head><meta charset="utf-8">
<script>
window.parserFinished = false;
document.addEventListener('DOMContentLoaded', () => { window.parserFinished = true; });
window.recordGate = () => {
document.querySelector('#result').textContent = 'parserFinished=' + window.parserFinished + '; paintCountBeforeScript=' + performance.getEntriesByType('paint').length;
};
</script>
<!-- Local server holds this response until DOMContentLoaded, then sends window.recordGate(); -->
<script async blocking="render" src="/gate.js"></script>
</head><body><h1>Content waiting to be painted</h1><output id="result"></output></body></html>Resultaat
parserFinished=true; paintCountBeforeScript=0
De bijbehorende testserver retourneert het beschreven script van één regel na DOMContentLoaded; het is geen externe dienst.