From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/location/replace/index.md | 87 ++++++++++++++---------------- 1 file changed, 39 insertions(+), 48 deletions(-) (limited to 'files/fr/web/api/location/replace') 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 --- -

{{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

-
// 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écificationStatutCommentaires
{{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

- - +{{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()")}}. -- cgit v1.2.3-54-g00ecf