HTMLLinkElement: fetchPriority 属性

Baseline 2024
新推出

自 2024 年 10 月以来,此功能已可在最新的设备和浏览器版本上使用。此功能可能不适用于旧设备或浏览器。

HTMLLinkElement 接口的 fetchPriority 属性表示一个给浏览器的提示,说明它应该如何相对于其他同类型资源来优先获取特定资源。它反映了相应 <link> 元素的 fetchpriority 属性。

该属性允许开发者表明,相对于浏览器在分配内部优先级时所能合理推断出的情况,在加载过程早期获取某个特定资源对用户体验的影响更大或更小,尤其是在预加载资源时。这反过来又允许浏览器增加或降低优先级,并可能比否则更早或更晚地加载资源。该属性应谨慎使用,因为过度或不正确的优先级设置会降低性能。

fetch priority 可用于补充 预加载,允许开发者提高资源的优先级,使其优先于默认以较高优先级预加载的不那么重要的资源。例如,如果某个特定图像对网站的 最大内容绘制 (LCP) 有显著贡献,则可以设置它以预加载并具有高 fetch priority。

请注意,任何获取操作的内部优先级以及 fetchPriority 对优先级的影响完全取决于浏览器。

一个表示优先级提示的字符串。可能的值为:

high

相对于其他同类型资源和内部优先级,以高优先级获取资源。

low

相对于其他同类型资源和内部优先级,以低优先级获取资源。

auto

不设置 fetch priority 的偏好。这是默认值。如果没有设置值或设置了无效值,则使用此选项。

示例

js
const preloadLink = document.createElement("link");
preloadLink.href = "my-image.jpg";
preloadLink.rel = "preload";
preloadLink.as = "image";
preloadLink.fetchPriority = "high";
document.head.appendChild(preloadLink);

规范

规范
HTML
# dom-link-fetchpriority

浏览器兼容性

另见