blob: 0811c18b610f48c3171d48dd8f0f476ed01b257d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
---
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
```js
// 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 |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- |
| {{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é des navigateurs
{{Compat("api.IDBIndex")}}
## Voir aussi
- L'interface {{domxref("Location")}} à laquelle appartient cette méthode.
- Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.reload()")}}.
|
