La méthode document.open() ouvre un document pour l'écriture.
document.open();
// 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.
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() 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(). 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().
Voir Security check basics 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écification | Status | Comment |
|---|---|---|
| {{SpecName("DOM2 HTML", "html.html#ID-72161170", "document.open()")}} | {{Spec2("DOM2 HTML")}} | Définition initiale. |
{{ CompatibilityTable() }}
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | {{ CompatVersionUnknown() }} | {{CompatVersionUnknown}} | {{ CompatVersionUnknown() }} | {{ CompatVersionUnknown() }} | {{ CompatVersionUnknown() }} | {{ CompatVersionUnknown() }} |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | {{ CompatUnknown() }} | {{CompatVersionUnknown}} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} |
À partir de Gecko 1.9, cette méthode est soumise à la même règle d'origine que les autres propriétés et ne fonctionne pas si cela change l'origine du document.
À partir de Gecko 1.9.2, document.open() utilise le principal du document dont il utilise l'URI, au lieu de récupérer le principal hors de la pile. Par conséquent, vous ne pouvez plus appeler {{domxref ("document.write ()")}} dans un document non approuvé à partir de chrome, même en utilisant wrappedJSObject.