Location.replace()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
Exemples
// 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 # dom-location-replace-dev |
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
replace |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- No support
- No support
- User must explicitly enable this feature.
Voir aussi
- L'interface
Location
à laquelle appartient cette méthode. - Méthodes similaires :
Location.assign()
etLocation.reload()
.