103 Early Hints

HTTP 103 Early Hints 資訊回應碼可能會在伺服器仍在準備回應時發送，提供有關伺服器預期的最終回應將連接到的站點和資源的提示。這允許瀏覽器在伺服器準備和發送最終回應之前進行預連接 (en-US)到站點或開始預加載 (en-US)資源。

早期提示回應主要用於 Link (en-US) 標頭，指示該標頭要加載的資源。它還可以包含一個 Content-Security-Policy 標頭，在處理早期提示時強制執行。

伺服器可能會發送多個 103 回應，例如在重定向後。瀏覽器僅處理第一個早期提示回應，如果請求導致跨源重定向，則必須丟棄此回應。來自早期提示的預加載資源將有效地預先添加到 Document 的 head 元素中，然後是最終回應中加載的資源。

備註： 出於兼容性原因，建議只在 HTTP/2 或更高版本上發送 HTTP 103 Early Hints 回應，除非已知用戶端正確處理信息回應。

由於這個原因，大多數瀏覽器限制在 HTTP/2 或更高版本中提供支持。請參見下面的瀏覽器相容性。

儘管如此，以下範例使用了 HTTP/1.1 風格的表示法，依照通常的慣例。

語法

http
103 Early Hints

範例

預連接範例

下面的 103 早期提示回應顯示了一個早期提示回應，其中伺服器指示用戶端可能希望對特定來源（https://cdn.example.com）進行預連接。就像 HTML rel=preconnect (en-US) 屬性一樣，這是一個提示，表明頁面可能需要目標資源來源的資源，並且瀏覽器可能通過預先啟動到該來源的連接來改善用戶體驗。

http
103 Early Hint
Link: <https://cdn.example.com>; rel=preconnect, <https://cdn.example.com>; rel=preconnect; crossorigin

這個例子預連接到 https://cdn.example.com 兩次：

  • 第一次連接將用於加載無需 CORS 的資源，例如圖像。
  • 第二次連接包括 crossorigin (en-US) 屬性，將用於加載 CORS 保護的資源，例如字型。

受 CORS 保護的資源必須通過完全獨立的連接進行提取。如果你只需要從來源獲取一類資源，則只需預先連接一次。

隨後伺服器發送最終回應。這包括跨源字體預加載和從附加來源加載的 <img>。

http
200 OK
Content-Type: text/html

<!DOCTYPE html>
...
<link rel="preload" href="https://cdn.example.com/fonts/myfont.woff2" as="font" type="font/woff2" crossorigin>
...
<img src="https://cdn.example.com/images/image.jpg" alt="">
...

預加載範例

下面的 103 早期提示回應指示最終回應可能需要樣式表 style.css。

http
103 Early Hint
Link: </style.css>; rel=preload; as=style

隨後伺服器發送最終回應。這包括指向樣式表的連接，該連接可能已經從早期提示中被預加載。

http
200 OK
Content-Type: text/html

<!DOCTYPE html>
...
<link rel="stylesheet" rel="preload" href="style.css" />
...

包含 CSP 的早期提示回應

以下範例展示了相同的早期提示回應，但包含了 Content-Security-Policy 標頭。

http
103 Early Hint
Content-Security-Policy: style-src: self;
Link: </style.css>; rel=preload; as=style

早期回應將預加載限制在與請求相同的來源上。如果原始憑證匹配，則樣式表將被預加載。

最終回應可能將 CSP 設置為 none，如下所示。樣式表已被預加載，但在呈現頁面時將不會被使用。

http
200 OK
Content-Security-Policy: style-src: none;
Content-Type: text/html

<!DOCTYPE html>
...
<link rel="stylesheet" rel="preload" href="style.css" />
...

規範

Specification
An HTTP Status Code for Indicating Hints
# section-2
HTML Standard
# early-hints

瀏覽器相容性

BCD tables only load in the browser

參見