CKTIS / HTML
blocking: wstrzymanie renderowania na czas zasobu
Rozróżniaj blokowanie obrazu strony, parsowania HTML i kolejności wykonywania skryptów.
Wersja: HTML Living Standard
Składnia
<script async blocking="render" src="/gate.js"></script>Atrybut blocking jest listą tokenów rozdzielonych spacjami, stosowaną na odpowiednich elementach skryptu, odnośnika arkusza stylów i stylu. Obecnie zdefiniowany token render żąda wstrzymania renderowania, gdy zasób blokuje ten proces. Znaczenie mają położenie i reguły przetwarzania elementu; skrypt mający blokować początkowe wyświetlenie należy umieścić w nagłówku dokumentu. To decyzja wydajnościowa, nie zabezpieczenie kodu.
Blokowanie renderowania różni się od blokowania parsera. Zewnętrzny skrypt z async może być pobierany bez zatrzymania parsowania HTML, a jednocześnie opóźniać pierwszy obraz. Atrybut nie ustala kolejności zależności między niezależnymi skryptami. Nadużywanie go może wydłużyć wyświetlanie pustej strony; stosuj go tylko do zasobów rzeczywiście koniecznych przed pokazaniem treści.
Lokalny scenariusz celowo wstrzymuje odpowiedź ze skryptem do zakończenia parsowania DOM. Skrypt sprawdza wtedy brak wpisów o malowaniu i zapisuje wynik. Test potwierdza także pierwsze malowanie treści po zwolnieniu odpowiedzi. Dotyczy kontrolowanego przypadku w Chromium 145, a nie gwarancji czasu w każdej sieci i przeglądarce.
Przykłady
<!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>Wynik
parserFinished=true; paintCountBeforeScript=0
Serwer testowy zwraca udokumentowany jednoliniowy skrypt po DOMContentLoaded; nie jest to zewnętrzna usługa.