aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/location/replace
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/location/replace
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/location/replace')
-rw-r--r--files/fr/web/api/location/replace/index.md87
1 files changed, 39 insertions, 48 deletions
diff --git a/files/fr/web/api/location/replace/index.md b/files/fr/web/api/location/replace/index.md
index 90fa954e20..0811c18b61 100644
--- a/files/fr/web/api/location/replace/index.md
+++ b/files/fr/web/api/location/replace/index.md
@@ -8,51 +8,42 @@ tags:
- Reference
translation_of: Web/API/Location/replace
---
-<p>{{APIRef("Location")}}</p>
-<p>La méthode <code><strong>Location.replace()</strong></code> remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé <code>replace()</code>, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton <em>précédent</em> pour y revenir.</p>
-<p>Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type <code>SECURITY_ERROR</code> est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.</p>
-<p>Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type <code>SYNTAX_ERROR</code> est lancée.</p>
-<h2 id="Syntaxe">Syntaxe</h2>
-<pre class="syntaxbox"><em>object</em>.replace(<em>url</em>);
-</pre>
-<h3 id="Paramètres">Paramètres</h3>
-<dl>
- <dt>
- <em>url</em></dt>
- <dd>
- {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.</dd>
-</dl>
-<h2 id="Exemples">Exemples</h2>
-<pre class="brush: js">// Navigue vers l'article <em>Location.reload</em> en remplaçant la page actuelle
-document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');</pre>
-<h2 id="Spécifications">Spécifications</h2>
-<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-replace", "Location.replace()")}}</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-replace", "Location.replace()")}}</td>
- <td>{{Spec2('HTML5 W3C')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("api.IDBIndex")}}</p>
-
-<h2 id="See_also">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.reload()")}}.</li>
-</ul>
+{{APIRef("Location")}}
+
+La méthode **`Location.replace()`** remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé `replace()`, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton _précédent_ pour y revenir.
+
+Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type `SECURITY_ERROR` est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.
+
+Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est lancée.
+
+## Syntaxe
+
+ object.replace(url);
+
+### Paramètres
+
+- _url_
+ - : {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.
+
+## Exemples
+
+```js
+// Navigue vers l'article Location.reload en remplaçant la page actuelle
+document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
+```
+
+## Spécifications
+
+| Spécification | Statut | Commentaires |
+| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- |
+| {{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. |
+| {{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. |
+
+## Compatibilité des navigateurs
+
+{{Compat("api.IDBIndex")}}
+
+## Voir aussi
+
+- L'interface {{domxref("Location")}} à laquelle appartient cette méthode.
+- Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.reload()")}}.