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.

La méthode Location.reload() recharge la ressource depuis l'URL actuelle.

Le rechargement peut être bloqué avec une exception DOMException SECURITY_ERROR. Cela se produit si l'origine du script qui invoque location.reload() est différente de l'origine de la page qui possède l'objet Location. Voir les règles sur l'origine pour plus d'informations.

Syntaxe

js
location.reload();

location.reload() n'a pas de paramètre

Firefox prend en charge un paramètre booléen non-standard forceGet pour la méthode location.reload(), qui permet à Firefox de passer outre le cache et d'effectuer un rafraîchissement forcé du document. Toutefois, pour tous les autres navigateurs, tout argument utilisé en appelant location.reload() sera ignoré et n'aura aucun effet.

Il est toutefois possible que vous rencontriez des occurrences de location.reload(true) dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "location.reload(true)" renvoie plusieurs centaines de milliers de résultats.

Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web a ouvert le sujet pour étudier son ajout à la spécification pour location.reload(). Toutefois, il n'a jamais été ajouté formellement.

En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle de location.reload() et n'en a d'ailleurs jamais fait partie.

Spécifications

Specification
HTML
# dom-location-reload-dev

Compatibilité des navigateurs

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.

Voir aussi