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

浏览器兼容性

另见