Dokument: write() Methode
Please take two minutes to fill out our short survey.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Warnung:
Die Verwendung der document.write() Methode wird dringend abgeraten.
Wie die HTML-Spezifikation selbst warnt:
Diese Methode hat sehr eigentümliches Verhalten. In einigen Fällen kann diese Methode den Zustand des HTML-Parsers beeinflussen, während dieser läuft, was zu einem DOM führt, das nicht dem Quellcode des Dokuments entspricht (z.B. wenn die geschriebene Zeichenkette die Zeichenkette
<plaintext>oder<!--ist). In anderen Fällen kann der Aufruf die aktuelle Seite zuerst löschen, als obdocument.open()aufgerufen worden wäre. In weiteren Fällen wird die Methode einfach ignoriert oder es wird eine Ausnahme ausgelöst. Nutzeragenten dürfen ausdrücklich vermeiden,script-Elemente auszuführen, die über diese Methode eingefügt wurden. Und um die Angelegenheit noch schlimmer zu machen, kann das genaue Verhalten dieser Methode in einigen Fällen von der Netzwerklatenz abhängen, was zu Fehlern führen kann, die sehr schwer zu debuggen sind. Aus all diesen Gründen wird die Verwendung dieser Methode dringend abgeraten. Daher sollten Siedocument.write()vermeiden – und, wenn möglich, vorhandenen Code aktualisieren, der diese Methode noch verwendet.
Die document.write() Methode schreibt eine Zeichenkette in einen Dokumentstrom, der durch document.open() geöffnet wurde.
Hinweis:
Da document.write() in den Dokument stream schreibt, ruft ein Aufruf von document.write() auf einem geschlossenen (geladenen) Dokument automatisch document.open() auf, was das Dokument löschen wird.
Syntax
write(markup)
Parameter
markup-
Eine Zeichenkette, die den Text enthält, der in das Dokument geschrieben werden soll.
Rückgabewert
Keiner (undefined).
Beispiele
<p>Some original document content.</p>
<button onclick="newContent()">Replace document content</button>
function newContent() {
document.open();
document.write("<h1>Out with the old, in with the new!</h1>");
document.close();
}
Anmerkungen
Der Text, den Sie schreiben, wird in das Strukturmodell des Dokuments geparst. Im obigen Beispiel wird das h1 Element zu einem Knoten im Dokument.
Das Schreiben in ein Dokument, das bereits geladen ist, ohne document.open() aufzurufen, wird automatisch document.open() aufrufen. Nach dem Schreiben sollten Sie document.close() aufrufen, um dem Browser mitzuteilen, das Laden der Seite abzuschließen.
Wenn der document.write() Aufruf innerhalb eines Inline-HTML-<script> Tags eingebettet ist, wird document.open() nicht aufgerufen. Zum Beispiel:
<script>
document.write("<h1>Main title</h1>");
</script>
document.write() und document.writeln funktionieren nicht in XHTML-Dokumenten (im Fehlerprotokoll erhalten Sie einen "Operation is not supported" (NS_ERROR_DOM_NOT_SUPPORTED_ERR) Fehler). Dies passiert beim Öffnen einer lokalen Datei mit der .xhtml Dateierweiterung oder für jedes Dokument, das mit einem application/xhtml+xml MIME-Typ bedient wird. Weitere Informationen finden Sie in den W3C XHTML FAQ.
Die Verwendung von document.write() in verzögerten oder asynchronen Skripten wird ignoriert und Sie erhalten eine Nachricht wie "A call to document.write() from an asynchronously-loaded external script was ignored" im Fehlerprotokoll.
Nur in Edge führt der mehrmalige Aufruf von document.write() in einem <iframe> zu dem Fehler "SCRIPT70: Permission denied".
Beginnend mit Version 55 wird Chrome <script>-Elemente, die durch document.write() eingefügt wurden, nicht ausführen, wenn bestimmte Bedingungen erfüllt sind. Weitere Informationen finden Sie unter Intervening against document.write().
Spezifikationen
| Specification |
|---|
| HTML # dom-document-write-dev |