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.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/fr/web/api/html_dom_api/index.md)

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 location.reload() et n'en a en fait jamais fait partie.

Spécifications

Specification
HTML Standard
# dom-location-reload-dev

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi