From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/location/replace/index.html | 100 +++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 files/fr/web/api/location/replace/index.html (limited to 'files/fr/web/api/location/replace') diff --git a/files/fr/web/api/location/replace/index.html b/files/fr/web/api/location/replace/index.html new file mode 100644 index 0000000000..bca43babfb --- /dev/null +++ b/files/fr/web/api/location/replace/index.html @@ -0,0 +1,100 @@ +--- +title: Location.replace() +slug: Web/API/Location/replace +tags: + - API + - JavaScript + - Méthode + - 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é

+

{{ CompatibilityTable() }}

+
+ + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari
Support de base{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+
+ + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Support de base{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+

Voir aussi

+ -- cgit v1.2.3-54-g00ecf