La méthode Location.replace() remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode assign() est que, après avoir utilisé replace(), la page actuelle ne sera pas enregistrée dans l'historique de session 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 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 Location, principalement quand le script est hébergé sur un autre domaine.

Si l'URL donnée n'est pas valide, une DOMException de type SYNTAX_ERROR est lancée.

Syntaxe

object.replace(url);

Paramètres

url
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écification Statut Commentaires
HTML Living Standard
La définition de 'Location.replace()' dans cette spécification.
Standard évolutif Pas de différence avec HTML5.
HTML5
La définition de 'Location.replace()' dans cette spécification.
Recommendation Définition initiale.

Compatibilité

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : fscholz, Watilin
Dernière mise à jour par : Watilin,