JavaScript: The Definitive Guide, Fourth Edition

Name

Document.writeln( ) — append data and a newline to a document

Availability

JavaScript 1.0

Synopsis

                  document.writeln(value, ...)

Arguments

value

An arbitrary JavaScript value to be appended to document. If the value is not a string, it is converted to one before being appended.

...

Any number (zero or higher) of additional values to be appended (in order) to document.

Description

Document.writeln( ) behaves just like Document.write( ) except that after appending all of its arguments to document, it also appends a newline character. See the Document.write( ) reference page for more information on this method.

Newline characters are not usually displayed in HTML documents, so Document.writeln( ) is generally useful only when writing text to appear in a <pre> environment, or when writing to a document opened with a MIME type of “text/plain”.

See Also

Document.close( ), Document.open( ), Document.write( )