aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/location/reload
diff options
context:
space:
mode:
authorSphinxKnight <SphinxKnight@users.noreply.github.com>2021-09-17 23:11:52 +0200
committerGitHub <noreply@github.com>2021-09-17 23:11:52 +0200
commit1678f2da63025db33c8ec8dc41c5295a94d4c555 (patch)
tree1d51d4d05c1aa6d390eff802b1aa6871118dba7c /files/fr/web/api/location/reload
parent55863edc03e9372073405d6e85fb0a28fdf65ea9 (diff)
downloadtranslated-content-1678f2da63025db33c8ec8dc41c5295a94d4c555.tar.gz
translated-content-1678f2da63025db33c8ec8dc41c5295a94d4c555.tar.bz2
translated-content-1678f2da63025db33c8ec8dc41c5295a94d4c555.zip
Fixes #2431 (#2452)
* Revamp window.location * Revamp location.reload
Diffstat (limited to 'files/fr/web/api/location/reload')
-rw-r--r--files/fr/web/api/location/reload/index.html59
1 files changed, 20 insertions, 39 deletions
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
---
<div>{{ APIRef("HTML DOM") }}</div>
-<p><span class="seoSummary">La méthode <code><strong>Location.reload()</strong></code> recharge la ressource depuis l'URL actuelle.</span></p>
+<p>La méthode <code><strong>location.reload()</strong></code> recharge l'URL courante, à la façon du bouton «&nbsp;Actualiser&nbsp;».</p>
-<p>Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type <code>SECURITY_ERROR</code> 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 <a href="/fr/docs/Web/Security/Same_origin_policy_for_JavaScript">Same-origin policy</a> pour plus d'informations.</p>
+<p>Le rechargement peut être bloqué avec une exception <a href="/fr/docs/Web/API/DOMException"><code>DOMException</code></a> <code>SECURITY_ERROR</code>. Cela se produit si <a href="/fr/docs/Glossary/Origin">l'origine</a> du script qui invoque <code>location.reload()</code> est différente de l'origine de la page qui possède l'objet <a href="/fr/docs/Web/API/Location"><code>Location</code></a>. Voir <a href="/fr/docs/Web/Security/Same-origin_policy">les règles sur l'origine</a> pour plus d'informations.</p>
-<h2 id="Syntaxe">Syntaxe</h2>
+<h2 id="syntaxe">Syntaxe</h2>
-<pre class="syntaxbox notranslate"><em>object</em>.reload();
+<pre class="brush: js">
+location.reload();
</pre>
-<h2 id="Exemples">Exemples</h2>
+<h2 id="location.reload_n_a_pas_de_paramètre">location.reload() n'a pas de paramètre</h2>
-<pre class="brush: js notranslate">// Recharge la page actuelle
-document.location.reload();</pre>
+<p>Firefox prend en charge un paramètre booléen non-standard <a href="https://searchfox.org/mozilla-central/source/dom/base/Location.cpp#551"><code>forceGet</code></a> pour la méthode <code>location.reload()</code>, 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 <code>location.reload()</code> sera ignoré et n'aura aucun effet.</p>
-<h2 id="Spécifications">Spécifications</h2>
+<p>Il est toutefois possible que vous rencontriez des occurrences de <code>location.reload(true)</code> dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "<code>location.reload(true)</code>" renvoie <a href="https://github.com/search?q=%22location.reload%28true%29%22&type=code">plusieurs centaines de milliers de résultats</a>.</p>
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaires</th>
- </tr>
- <tr>
- <td>{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}</td>
- <td>{{Spec2('HTML WHATWG')}}</td>
- <td>Pas de différence avec {{SpecName("HTML5 W3C")}}.</td>
- </tr>
- <tr>
- <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}</td>
- <td>{{Spec2('HTML5 W3C')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
+<p>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 href="https://www.w3.org/2005/06/tracker/webapi/issues/69">a ouvert le sujet</a> pour étudier son ajout à la spécification pour <code>location.reload()</code>. Toutefois, il n'a jamais été ajouté formellement.</p>
-<h2 id="Compatibilité">Compatibilité</h2>
+<p>En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle <code>location.reload()</code> et n'en a en fait jamais fait partie.</p>
+<h2 id="spécifications">Spécifications</h2>
+<p>{{Specifications}}</p>
-<p>{{Compat("api.Location.reload")}}</p>
+<h2 id="compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
-<h2 id="Voir_aussi">Voir aussi</h2>
+<p>{{Compat}}</p>
+
+<h2 id="voir_aussi">Voir aussi</h2>
<ul>
- <li>L'interface {{domxref("Location")}} à laquelle appartient cette méthode.</li>
- <li>Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.replace()")}}.</li>
+ <li>L'interface <a href="/fr/docs/Web/API/Location"><code>Location</code></a> à laquelle appartient cette méthode.</li>
+ <li>Des méthodes semblables&nbsp;: <a href="/fr/docs/Web/API/Location/assign"><code>Location.assign()</code></a> et <a href="/fr/docs/Web/API/Location/replace"><code>Location.replace()</code></a>.</li>
</ul>