coderef

blocking="render"Limited availability

The blocking="render" attribute for <link>, <script>, and <style> elements blocks rendering until the external script or stylesheet has been loaded. For <link rel="expect">, rendering is blocked until a specific element is in the DOM.

Not yet supported in all major browsers — check the table and provide a fallback.

Browser support

DesktopChrome
1–104Not supported
105+Supportedsince Sep 2, 2022
Current: 155
Edge
12–104Not supported
105+Supportedsince Sep 1, 2022
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
1–18.1Not supported
18.2+Supportedsince Dec 11, 2024
Current: 27
MobileChrome Android
18–104Not supported
105+Supportedsince Sep 2, 2022
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
1–18.1Not supported
18.2+Supportedsince Dec 11, 2024
Current: 27

How to use

Not supported in Firefox, Firefox Android. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: blocking.

Feature detection

JS · check before using
if ("HTMLLinkElement" in globalThis && "blocking" in HTMLLinkElement.prototype) {
  // HTMLLinkElement.blocking is available
}

Sub-features

Support for each part of the feature (6). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
HTMLLinkElement.blocking105105✕18.2105✕18.2
HTMLScriptElement.blocking105105✕18.2105✕18.2
HTMLStyleElement.blocking105105✕18.2105✕18.2
link.blocking105105✕18.2105✕18.2
script.blocking105105✕18.2105✕18.2
style.blocking105105✕18.2105✕18.2