このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Refresh ヘッダー

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

HTTP の Refresh レスポンスヘッダーは、ページの読み込みが完了してから指定された時間が経過した時点で、ブラウザーにページを更新またはリダイレクトするよう指示するものです。 これは、HTMLで<meta http-equiv="refresh" content="...">を使用することと完全に同等です。

メモ: これは HTTP レスポンスに含まれますが、Refresh ヘッダーは HTML の読み込み処理によって処理され、HTTP リダイレクトや JavaScript によるリダイレクトの後に実行されます。情報については、リダイレクトの優先順位を参照してください。

メモ: 新しいページに更新リダイレクトされた場合、新しいページへのリクエストには Referer ヘッダーが含まれます(Referrer-Policy で許可されている場合)。また、移動後の document.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

ブラウザーの互換性

関連情報