HTMLImageElement: fetchPriority 屬性

Baseline 2024
新推出

自 2024 年 10 月以來,此功能已可在最新的裝置和瀏覽器版本上使用。此功能可能不適用於舊裝置或瀏覽器。

HTMLImageElement 介面的 fetchPriority 屬性表示一個向瀏覽器發出的提示,指示瀏覽器應如何相對於其他圖片來優先獲取該圖片。它反映了相應 <img> 元素的 fetchpriority 屬性。

該屬性允許開發者發出訊號,表明在載入過程早期獲取某個圖片對使用者體驗的影響比瀏覽器在分配內部優先順序時可以合理推斷出的要大或小。這反過來又允許瀏覽器增加或減少優先順序,並可能比平時更早或更晚地載入圖片。該屬性應謹慎使用,因為過度或不正確的優先順序設定會降低效能。

fetchPriority 可用於補充 預載入,允許開發者提高某個圖片相對於預設優先順序較高的、影響較小的資源的優先順序。例如,如果開發者知道某個圖片對網站的 最大內容繪製 (LCP) 有顯著貢獻,他們可以為該圖片新增 <link rel="preload">,然後使用 fetchPriority 屬性進一步提高其優先順序。

請注意,任何獲取操作的內部優先順序以及 fetchPriority 對優先順序的影響完全取決於瀏覽器。

一個表示優先順序提示的字串。可能的值為:

high

相對於具有相同內部優先順序的其他圖片,以高優先順序獲取該圖片。

low

相對於具有相同內部優先順序的其他圖片,以低優先順序獲取該圖片。

auto

不為獲取優先順序設定使用者偏好。這是預設值。如果沒有設定值或設定了無效值,則使用此值。

示例

js
const img = new Image();
img.fetchPriority = "high";
img.src = "img/logo.png";

規範

規範
HTML
# dom-img-fetchpriority

瀏覽器相容性

另見