--- title: Document.writeln() slug: Web/API/Document/writeln translation_of: Web/API/Document/writeln ---
{{ ApiRef("DOM") }}
Escribe una cadena de texto en el documento, seguida de una nueva línea.
Nota: dado que document.writeln
(al igual que document.write)
escribe directo al hilo (stream
) de un documento, la llamada a document.write
en un documento ya cargado automáticamente ejecuta document.open
, lo cual limpiará todo el contenido del documento en cuestión.
document.writeln(línea);
línea
es la cadena conteniendo una línea de texto.document.writeln("<p>¡Hola mundo!</p>");
document.writeln actúa igual que document.write exepto que agrega un carácter de nueva línea (\n
) al final del texto a escribir.
document.write
y document.writeln
no funcionan dentro de un documento XHTML (obtendrás un mensaje de error que dice "Operación no soportada" ("Operation is not supported") [NS_ERROR_DOM_NOT_SUPPORTED_ERR
] en la consola). Esto sucede cuando abrimos un archivo local de extensión .xhtml o para cualquier document servido con un MIME del tipo application/xhtml+xml
. Hay más información disponible en W3C XHTML FAQ.document.writeln
y document.write
en scripts de modo diferido o asyncrónico serán ignorados, y recibirás un mensaje de error en la consola del tipo "Una llamada a document.write() desde un script cargado asincrónicamente fue ignorado" ("A call to document.write()
from an asynchronously-loaded external script was ignored").