Location.reload()

Location.reload() メソッドは、Refresh ボタンのように現在のリソースをリロードします。

このメソッドはオプションの Boolean パラメータを持ちます。これはデフォルトでは false です。true の場合、ブラウザのキャッシュを無視して、ページは常にサーバーからリロードされます。

forcedReload フラグは、一部のブラウザがユーザのスクロール位置を処理する方法を変更します。通常 reload() は後でスクロール位置を復元しますが、window.scrollY === 0 のように、強制モードでページの先頭に戻ることができます。

再読み込みはブロックされ、SECURITY_ERROR DOMException が投げられるかもしれません。これは、Location.reload() を呼び出すスクリプトの origin が、 Location オブジェクトを所有するページの由来と異なる場合に発生します。詳細については、同一生成元ポリシーを参照してください。

構文

location.reload(forcedReload);

パラメータ

forcedReload Optional
ページが常にサーバからリロードされることを示す Booleanfalse または未指定の場合、ブラウザは HTTP キャッシュからページをリロードする可能性があります。

// ブラウザキャッシュなしで現在のページを再読み込みします
location.reload(true);

仕様

仕様書 ステータス コメント
HTML Living Standard
Location.reload() の定義
現行の標準 HTML5 からの変更はありません。
HTML5
Location.reload() の定義
勧告 初期定義

ブラウザの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
reloadChrome 完全対応 ありEdge 完全対応 12
補足
完全対応 12
補足
補足 If a page added to Trusted Sites contains a cross-origin iframe, then calling reload() from within the iframe reloads the trusted page (in other words, the top page reloads, not the iframe).
Firefox 完全対応 ありIE 完全対応 あり
補足
完全対応 あり
補足
補足 If a page added to Trusted Sites contains a cross-origin iframe, then calling reload() from within the iframe reloads the trusted page (in other words, the top page reloads, not the iframe).
Opera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 ありOpera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
実装ノートを参照してください。
実装ノートを参照してください。

あわせて参照