From 1678f2da63025db33c8ec8dc41c5295a94d4c555 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Fri, 17 Sep 2021 23:11:52 +0200 Subject: Fixes #2431 (#2452) * Revamp window.location * Revamp location.reload --- files/fr/web/api/location/reload/index.html | 59 ++++++++++------------------- 1 file changed, 20 insertions(+), 39 deletions(-) (limited to 'files/fr/web/api/location/reload') diff --git a/files/fr/web/api/location/reload/index.html b/files/fr/web/api/location/reload/index.html index c825101853..891a307902 100644 --- a/files/fr/web/api/location/reload/index.html +++ b/files/fr/web/api/location/reload/index.html @@ -1,61 +1,42 @@ --- -title: Location.reload() +title: 'Location : reload()' slug: Web/API/Location/reload -tags: - - API - - JavaScript - - Location - - Méthode - - Reference translation_of: Web/API/Location/reload +browser-compat: api.Location.reload ---
{{ APIRef("HTML DOM") }}
-

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

+

La méthode location.reload() recharge l'URL courante, à la façon du bouton « Actualiser ».

-

Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type SECURITY_ERROR est lancée. Cela se produit si l'origine du script appelant est différente de l'origine de la page initialement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine. Voir la page Same-origin policy pour plus d'informations.

+

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

+

Syntaxe

-
object.reload();
+
+location.reload();
 

 
-
Exemples

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

 
-
// Recharge la page actuelle
-document.location.reload();

+
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.

 
-
Spécifications

+
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.

 
-
- 
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
- 
-
SpécificationStatutCommentaires
{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML WHATWG')}}Pas de différence avec {{SpecName("HTML5 W3C")}}.
{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}{{Spec2('HTML5 W3C')}}Définition initiale.

+
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.

 
-
Compatibilité

+
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

 
+
{{Specifications}}

 
-
{{Compat("api.Location.reload")}}

+
Compatibilité des navigateurs

 
-
Voir aussi

+
{{Compat}}

+
+
Voir aussi

 
 
-- 
cgit v1.2.3-54-g00ecf