W3cubDocs

/Web APIs

HTMLLinkElement: blocking property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The blocking property of the HTMLLinkElement interface is a string indicating that certain operations should be blocked on the fetching of an external resource.

It reflects the blocking attribute of the <link> element.

Value

A string. Must be a space-separated list of blocking tokens listed below indicating the operations that are to be blocked:

render

The rendering of content on the screen is blocked.

Note: Only link elements in the document's <head> can possibly block rendering. By default, a link element with rel="stylesheet" in the <head> blocks rendering when the browser discovers it during parsing. If such a link element is added dynamically via script, you must additionally set blocking = "render" for it to block rendering.

Examples

<link
  id="el"
  rel="stylesheet"
  href="/example.css"
  blocking="render"
  crossorigin />

const el = document.getElementById("el");
console.log(el.blocking); // Output: "render"

Specifications

Specification
HTML>
# dom-link-blocking>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
blocking 105 105 No 91 18.2 105 No 72 18.2 20.0 105 18.2

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLLinkElement/blocking