blob: c427d5df05370b596910d3e92b829272abb3fb7e (
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
50
51
52
53
|
---
title: document.open
slug: Web/API/Document/open
tags:
- API
- DOM
- Méthodes
- Reference
translation_of: Web/API/Document/open
---
{{APIRef("DOM")}}
La méthode **`document.open()`** ouvre un document pour [l'écriture](/fr/docs/Web/API/Document/write).
## Syntaxe
document.open();
## Exemple
// Dans cet exemple, le contenu du document est
// écrasé au cours de la réinitialisation avec open()
document.write("<html><p>supprimez-moi</p></html>");
document.open();
// Le document est vide.
## Notes
Si un document existe dans la cible, cette méthode le supprime (voir l'exemple ci-dessus).
Par ailleurs, un appel automatique à `document.open()` est réalisé lorsque [document.write()](/fr/docs/Web/API/Document/write) est appelé après que la page ait été chargée, bien que ce ne soit pas défini dans la spécification du W3C. documenter les paramètres à document.open ne figurant pas dans la spécification
Cette méthode ne doit pas être confondue avec [window.open()](/fr/docs/Web/API/Window/open). `document.open` permet d'écrire par dessus le document courant ou d'y ajouter du contenu, alors que `window.open` fournit une manière d'ouvrir une nouvelle fenêtre laissant le document courant intact. Comme `window` est l'objet, si on appelle juste `open(...)`, il sera traité comme un appel à `window.open(...)`. Le document ouvert peut être fermé à l'aide de [document.close()](/fr/docs/Web/API/Document/close).
Voir [Security check basics](/fr/docs/Mozilla/Gecko/Script_security#Security_checks) pour plus d'informations sur les principaux.
Si vous ne voulez pas créer une entrée d'historique, remplacez `open()` par `open("text/html", "replace")`.
## Spécifications
| Spécification | Status | Comment |
| -------------------------------------------------------------------------------------------- | -------------------------------- | -------------------- |
| {{SpecName("HTML WHATWG", "#dom-document-open", "document.open()")}} | {{Spec2("HTML WHATWG")}} | |
| {{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}} | {{Spec2("DOM2 HTML")}} | Définition initiale. |
## Compatibilité des navigateurs
{{Compat("api.Document.open")}}
## Voir aussi
- {{domxref("Document")}}
- {{domxref("Window.open()")}}
|
