Location.replace()
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
js
object.replace(url);
Paramètres
Exemples
js
// Navigue vers l'article Location.reload en remplaçant la page actuelle
document.location.replace(
"https://developer.mozilla.org/fr/docs/Web/API/Location.reload",
);
Spécifications
Specification |
---|
HTML Standard # dom-location-replace-dev |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- L'interface
Location
à laquelle appartient cette méthode. - Méthodes similaires :
Location.assign()
etLocation.reload()
.