WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

blocking: Darstellung für eine Ressource verzögern

Unterscheide das Blockieren der Darstellung vom HTML-Parsen und der Ausführungsreihenfolge von Skripten.

Version: HTML Living Standard

Syntax

<script async blocking="render" src="/gate.js"></script>

Das Attribut blocking ist eine durch Leerzeichen getrennte Tokenliste auf dafür vorgesehenen Skript-, Stylesheet-Link- und Style-Elementen. Das derzeit definierte Token render fordert, dass die Darstellung wartet, solange die Ressource blockiert. Platzierung und Verarbeitungsregeln des jeweiligen Elements sind entscheidend; ein Skript, das die erste Darstellung blockieren soll, gehört in den Dokumentkopf. Dies ist eine Leistungsentscheidung, keine Sicherheitsbeschränkung für Code.

Das Blockieren der Darstellung unterscheidet sich vom Blockieren des Parsers. Ein externes Skript mit async kann geladen werden, ohne das HTML-Parsen anzuhalten, und dennoch separat die erste Darstellung verzögern. Das Attribut legt keine Abhängigkeitsreihenfolge zwischen unabhängigen Skripten fest. Unbedachter Einsatz kann die Seite länger leer lassen; verwende es nur für Ressourcen, die wirklich vor der Anzeige bereit sein müssen.

Die lokale Testkonfiguration hält das externe Skript absichtlich zurück, bis das DOM vollständig geparst wurde. Das Skript beobachtet dann, dass noch keine Paint-Einträge vorliegen, und liefert das Ergebnis. Der Test bestätigt außerdem einen First Contentful Paint nach der Freigabe. Er prüft diesen kontrollierten Fall in Chromium 145, keine Zeitgarantie für jedes Netzwerk und jeden Browser.

Beispiele

<!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>

Ergebnis

parserFinished=true; paintCountBeforeScript=0

Der zugehörige lokale Testserver liefert das dokumentierte einzeilige Skript nach DOMContentLoaded; er ist kein externer Dienst.

Quellen