Refresh 頭

HTTP Refresh 響應頭指示網頁瀏覽器在頁面完全載入後經過指定時間後重新整理或重定向頁面。它與在 HTML 中使用 <meta http-equiv="refresh" content="..."> 完全等效。

注意: 即使 Refresh 頭存在於 HTTP 響應中,它仍然由 HTML 載入機制處理,並在 HTTP 或 JavaScript 重定向之後發生。有關更多資訊,請參閱重定向優先順序

注意: 當重新整理重定向到新頁面時,如果 Referrer-Policy 允許,Referer 頭將包含在新頁面的請求中,並且在導航後 document.referrer 將設定為 referrer URL。

頭型別 響應頭
禁止請求頭

語法

http
Refresh: <time>
Refresh: <time>, url=<url>
Refresh: <time>; url=<url>
<time>

頁面重新整理前的非負秒數。小數部分被識別但被忽略;您應該只指定整數。

<url> 可選

如果存在,瀏覽器將重定向到指定的 URL,而不是使用當前 URL 進行重新整理。此 URL 可以加引號或不加引號。url= 字首不區分大小寫且可選。

示例

在特定時間後重新整理頁面

此頭將導致瀏覽器在頁面完全載入(即在 load 事件之後)5 秒後重新整理頁面。

http
Refresh: 5

在特定時間後重定向

此頭將導致瀏覽器在頁面完全載入 5 秒後重定向到某個 URL。

http
Refresh: 5; url=https://example.com/

注意: 有關自動重定向對可訪問性的重要影響,請參閱 HTML 參考中的 http-equiv="refresh" 屬性。

規範

規範
HTML
# the-refresh-header

瀏覽器相容性

另見