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

瀏覽器相容性

另見