Dokument: open()-Methode

DieDocument.open()-Methode öffnet ein Dokument zumSchreiben.

Dies hat einige Nebeneffekte. Zum Beispiel:

Alle aktuell im Dokument registrierten Ereignislistener, Knoten im Dokument oder das Fenster des Dokuments werden entfernt.
Alle vorhandenen Knoten werden aus dem Dokument entfernt.

Syntax

open()

Beispiele

Der folgende einfache Code öffnet das Dokument und ersetzt seinen Inhalt durch eine Reihe verschiedener 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 automatischerdocument.open()-Aufruf erfolgt, wenndocument.write() nach dem Laden der Seite aufgerufen wird.

Inhaltssicherheit

Diese Methode unterliegt der gleichenSame-Origin-Policy wie andere Eigenschaften und funktioniert nicht, wenn dies zu einer Änderung des Ursprungs des Dokuments führen würde.

Drei-Argumente document.open()

Es gibt eine weniger bekannte und wenig genutzte Drei-Argumente-Version vondocument.open(), die ein Alias fürWindow.open() ist (siehedessen Seite für vollständige Details).

Dieser Aufruf öffnet zum Beispiel github.com in einem neuen Fenster, wobei dessen opener aufnull gesetzt ist:

document.open("https://www.github.com", "", "noopener=true");

Zwei-Argumente document.open()

Browser unterstützten früher ein Zwei-Argumentedocument.open(), mit derfolgenden Signatur:

document.open(type, replace);

Wotype den MIME-Typ der Daten, die Sie schreiben (z.B.text/html) angab, undreplace, wenn gesetzt (d.h. eine Zeichenfolge von"replace"),spezifizierte, dass der Verlaufseintrag für das neue Dokument den aktuellen Verlaufseintrag des Dokuments, in das geschrieben wird, ersetzen würde.

Diese Form ist jetzt veraltet; sie wirft keinen Fehler, sondern leitet stattdessen einfach andocument.open() weiter (d.h. ist äquivalent zum Ausführen ohneArgumente). Das Verhalten des Verlaufsersetzens tritt jetzt immer auf.