Document.write()
Escribe una cadena de texto dentro del hilo de un document
abierto por document.open().
Nota: Dado 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.
Sintaxis
document.write(texto);
texto
es una cadena de texto que contiene el texto a ser impreso en el documento.
Example
<html>
<head>
<title>Ejemplo de write</title>
<script>
function nuevoContenido() {
alert("carga el contenido nuevo");
document.open();
document.write(
"<h1>Quita el contenido viejo - Agrega el contenido nuevo!</h1>",
);
document.close();
}
</script>
</head>
<body onload="nuevoContenido();">
<p>Algo de contenido original del documento</p>
</body>
</html>
Notas
Escribir a un documento que ya tiene contenido cargado previamente sin llamar a document.open()
, automáticamente hará una llamada a document.open(). Después de haber finalizado la escritura del documento, es recomendable llamar a document.close()
, para informar al navegador que la carga de la página ya ha terminado. El texto que escribas allí es convertido a la estructura tipificada de HTML dentro del modelo estructural del documento. En el ejemplo de más arriba, el elemento h1 se convierte en un nodo dentro del documento.
Si la llamada a document.write() se ejecuta dentro de una etiqueta <script>
incluído en el HTML, entonces la llamada a document.open() nunca ocurrirá. Por ejemplo:
<script>
document.write("<h1>Título Principal</h1>");
</script>
Nota: 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.
Nota: 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").
Especificaciones
Specification |
---|
HTML Standard # dom-document-write-dev |
Compatibilidad del Navegador
BCD tables only load in the browser