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
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
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()
.