location: reload() メソッド
location.reload()
メソッドは、再読み込みボタンのように現在の URL を再読み込みします。
再読み込みはブロックされ、 SECURITY_ERROR
の DOMException
が発生する可能性があります。これは、 location.reload()
を呼び出すスクリプトのオリジンが、 Location
オブジェクトを保持するページのオリジンと異なる場合に発生します。詳細については、同一オリジンポリシーを参照してください。
構文
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
関連情報
- 所属先の
Location
インターフェイス - 同様のメソッド:
Location.assign()
およびLocation.replace()