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_ERRORDOMException が発生する可能性があります。これは、 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
# dom-location-reload-dev

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
reload

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
User must explicitly enable this feature.

関連情報