Document: open() Methode
Die Document.open()
-Methode öffnet ein Dokument zum
Schreiben.
Dies hat einige Nebeneffekte. Zum Beispiel:
- Alle derzeit im Dokument, in Dokumentknoten oder im Fenster des Dokuments registrierten Event-Listener werden entfernt.
- Alle vorhandenen Knoten werden aus dem Dokument entfernt.
Syntax
open()
Parameter
Keine.
Rückgabewert
Eine Document
-Objektinstanz.
Beispiele
Der folgende einfache Code öffnet das Dokument und ersetzt seinen Inhalt durch eine Reihe unterschiedlicher HTML-Fragmente, bevor es wieder geschlossen wird.
document.open();
document.write("<p>Hello world!</p>");
document.write("<p>I am a fish</p>");
document.write("<p>The number is 42</p>");
document.close();
Hinweise
Ein automatischer document.open()
-Aufruf erfolgt, wenn
document.write()
nach dem Laden der Seite aufgerufen wird.
Inhaltssicherheit
Diese Methode unterliegt derselben Same-Origin-Policy wie andere Eigenschaften und funktioniert nicht, wenn dies dazu führen würde, dass der Ursprung des Dokuments geändert wird.
Drei-Argumente document.open()
Es gibt eine weniger bekannte und kaum genutzte Drei-Argumente-Version von
document.open()
, die ein Alias für Window.open()
ist (siehe
die entsprechende Seite für vollständige Details).
Dieser Aufruf öffnet beispielsweise github.com in einem neuen Fenster, wobei sein Opener auf
null
gesetzt ist:
document.open("https://www.github.com", "", "noopener=true");
Zwei-Argumente document.open()
Browser unterstützten früher eine Zwei-Argumente-Version von document.open()
, mit der
folgenden Signatur:
document.open(type, replace);
Dabei spezifizierte type
den MIME-Typ der Daten, die Sie schreiben (z.B.
text/html
) und wenn replace
gesetzt war (d.h. ein String von "replace"
), wurde angegeben, dass der Verlaufs-Eintrag für das neue Dokument den aktuellen Verlaufs-Eintrag des Dokuments ersetzt, zu dem geschrieben wird.
Diese Form ist jetzt veraltet; sie wirft keinen Fehler, sondern leitet einfach an
document.open()
weiter (d.h. ist gleichbedeutend mit dem Ausführen ohne
Argumente). Das Verhalten der Verlaufsersetzung erfolgt nun immer.
Spezifikationen
Specification |
---|
HTML Standard # dom-document-open-dev |
Browser-Kompatibilität
BCD tables only load in the browser