location: reload() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

location.reload() メソッドは、再読み込みボタンのように現在の URL を再読み込みします。

再読み込みはブロックされ、 SECURITY_ERROR の DOMException が発生する可能性があります。これは、 location.reload() を呼び出すスクリプトのオリジンが、 Location オブジェクトを保持するページのオリジンと異なる場合に発生します。詳細については、同一オリジンポリシーを参照してください。

構文

js
reload()

引数

なし。

メモ: Firefox は標準外の論理値の forceGet 引数 を location.reload() で対応しており、 Firefox にキャッシュをバイパスして現在の文書を強制的に再読み込みするように指示することができます。しかし、他のすべてのブラウザーでは、location.reload() の呼び出しで指定した引数は無視され、いかなる効果も持ちません。

しかし、すべてのブラウザーで強制再読み込みの効果が発生することを前提に書かれた既存のコードで location.reload(true) のインスタンスに出会うことがあるかもしれません。 GitHub で "location.reload(true)" を検索すると、数十万件の結果が得られます。ということは、既存のコードの中にもそれがあるものがたくさんあるのです。

その歴史は、 Netscape Navigator のある版で対応が追加され、それが最終的に Firefox で取り上げられたようです。そして、あるとき W3C Web APIs Working Group が location.reload() の仕様に追加することを検討するための課題を取り上げました。しかし、実際に追加されることはありませんでした。

つまり、論理値の引数は現在の location.reload() の仕様には含まれていませんし、実際、これまでに発表された location.reload() の仕様には含まれていません。

返値

なし (undefined)。

仕様書

Specification
HTML Standard
# dom-location-reload-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報