Document.write()

Deprecated

Avoid using this feature in new projects. The dynamic markup insertion API, which includes document.write(), has "very idiosyncratic behavior" which can be difficult to debug. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: DOM.

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

<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:

html

<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").