document: writeln() method

Warning: Use of the document.writeln() method is strongly discouraged.

As the HTML spec itself warns:

This method has very idiosyncratic behavior. In some cases, this method can affect the state of the HTML parser while the parser is running, resulting in a DOM that does not correspond to the source of the document (e.g. if the string written is the string "<plaintext>" or "<!--"). In other cases, the call can clear the current page first, as if document.open() had been called. In yet more cases, the method is simply ignored, or throws an exception. Users agents are explicitly allowed to avoid executing script elements inserted via this method. And to make matters even worse, the exact behavior of this method can in some cases be dependent on network latency, which can lead to failures that are very hard to debug. For all these reasons, use of this method is strongly discouraged. Therefore, avoid using document.writeln() — and if possible, update any existing code that is still using it.

Writes a string of text followed by a newline character to a document.

Syntax

js

writeln(line)

Parameters

  • line is string containing a line of text.

Return value

None (undefined).

Examples

js

document.writeln("<p>enter password:</p>");

Notes

document.writeln is the same as document.write but adds a newline.

Note: document.writeln (like document.write) does not work in XHTML documents (you'll get a "Operation is not supported" (NS_ERROR_DOM_NOT_SUPPORTED_ERR) error on the error console). This is the case if opening a local file with a .xhtml file extension or for any document served with an application/xhtml+xml MIME type. More information is available in the W3C XHTML FAQ.

Specifications

Specification
HTML Standard
# dom-document-writeln-dev

Browser compatibility

BCD tables only load in the browser