Document: writeln() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Warnung:
Die Verwendung der document.writeln()
-Methode wird dringend abgeraten.
Wie die HTML-Spezifikation selbst warnt:
Diese Methode hat sehr eigenwilliges Verhalten. In einigen Fällen kann diese Methode den Zustand des HTML-Parsers beeinträchtigen, während der Parser läuft, was zu einem DOM führt, das nicht mit der Quelle des Dokuments übereinstimmt (z.B. wenn die geschriebene Zeichenfolge "
<plaintext>
" oder "<!--
" ist). In anderen Fällen kann der Aufruf zunächst die aktuelle Seite löschen, als obdocument.open()
aufgerufen worden wäre. In noch weiteren Fällen wird die Methode einfach ignoriert oder es wird eine Ausnahme ausgelöst. Benutzeragenten sind ausdrücklich dazu berechtigt, die Ausführung vonscript
-Elementen, die mit dieser Methode eingefügt wurden, zu vermeiden. Und um die Sache noch schlimmer zu machen, kann das genaue Verhalten dieser Methode in einigen Fällen von der Netzwerklatenz abhängen, was zu schwer zu behebenden Fehlern führen kann. Aus all diesen Gründen wird die Verwendung dieser Methode stark abgeraten. Daher solltedocument.writeln()
vermieden werden — und wenn möglich, sollte vorhandener Code, der diese Methode noch verwendet, aktualisiert werden.
Schreibt eine Zeichenfolge gefolgt von einem Zeilenumbruch in ein Dokument.
Syntax
writeln(line)
Parameter
line
-
Eine Zeichenfolge, die eine Textzeile enthält.
Rückgabewert
Keiner (undefined
).
Beispiele
document.writeln("<p>enter password:</p>");
Hinweise
document.writeln ist dasselbe wie document.write
, fügt jedoch einen Zeilenumbruch hinzu.
Hinweis: document.writeln (wie document.write) funktioniert nicht in XHTML-Dokumenten (es erscheint ein "Operation is not supported" (NS_ERROR_DOM_NOT_SUPPORTED_ERR
) Fehler in der Fehlerkonsole). Dies ist der Fall, wenn eine lokale Datei mit einer .xhtml-Dateierweiterung geöffnet wird oder für jedes Dokument, das mit einem application/xhtml+xml MIME-Typ bereitgestellt wird. Weitere Informationen sind in den W3C XHTML FAQ verfügbar.
Spezifikationen
Specification |
---|
HTML Standard # dom-document-writeln-dev |
Browser-Kompatibilität
BCD tables only load in the browser