HEAD 請求方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HEAD HTTP 方法以標頭的形式請求資源的元資料,這些標頭是如果使用 GET 方法伺服器將傳送的。此方法可用於 URL 可能會產生大量下載的情況,例如,HEAD 請求可以讀取 Content-Length 標頭,以在用 GET 下載檔案之前檢查檔案大小。

如果對 HEAD 請求的響應顯示快取的 URL 響應現在已過時,則即使沒有發出 GET 請求,快取副本也會失效。

警告: 如果 HEAD 請求的響應包含正文,則必須忽略響應正文。任何描述錯誤正文的表示標頭都被認為是描述 GET 請求將接收到的響應正文。

請求有正文
成功響應有正文
安全
冪等
可快取
允許在 HTML 表單中使用

語法

http
HEAD <request-target>["?"<query>] HTTP/1.1
<請求目標>

Host 標頭中提供的資訊結合使用時,標識請求的目標資源。這是對源伺服器的請求中的絕對路徑(例如,/path/to/file.html),以及對代理的請求中的絕對 URL(例如,http://www.example.com/path/to/file.html)。

<query> 可選

一個可選的查詢元件,前面帶有一個問號 ?。通常用於以 key=value 對的形式攜帶識別資訊。

示例

成功檢索資源元資料

以下 curl 命令為 example.com 建立一個 HEAD 請求

bash
curl --head example.com

這與 GET 請求等效,只是伺服器不應在響應中包含訊息正文。它建立了一個如下所示的 HTTP 請求

http
HEAD / HTTP/1.1
Host: example.com
User-Agent: curl/8.6.0
Accept: */*

伺服器只發送由標頭組成的 200 OK 響應。響應實際上是描述資源的元資料而不是資源本身(此示例中省略了一些快取標頭,以簡潔起見)

http
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Wed, 04 Sep 2024 10:33:11 GMT
Content-Length: 1234567

規範

規範
HTTP 語義
# HEAD

瀏覽器相容性

另見