Document.open()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
El método Document.open()
abre un documento para escritura (writing)
Esto viene con algunos efectos secundarios. Por ejemplo:
- Todos las atenciones de eventos actualmente registrados en el documento, los nodos dentro del documento o la ventana del documento son eliminados.
- Todos los nodos existentes se eliminan del documento.
Sintaxis
document.open();
Parametros
Ninguno.
Valor devuelto
Una instancia del objeto Document (Document)
.
Ejemplos
El código simple a continuación abre el documento y reemplaza su contenido con un número de diferentes fragmentos HTML antes de cerrarlo nuevamente.
document.open();
document.write("<p>Hola mundo!</p>");
document.write("<p>Soy un pez</p>");
document.write("<p>El numero es 42</p>");
document.close();
Notas
Nota: Traducción pendiente para el texto que sigue
An automatic document.open()
call happens when document.write()
is called after the page has loaded.
For years Firefox and Internet Explorer additionally erased all JavaScript variables, etc., in addition to removing all nodes. This is no longer the case.document non-spec'ed parameters to document.open
Gecko-specific notes
Starting with Gecko 1.9, this method is subject to the same same-origin policy as other properties, and does not work if doing so would change the document's origin.
Starting with Gecko 1.9.2, document.open()
uses the principal of the document whose URI it uses, instead of fetching the principal off the stack. As a result, you can no longer call document.write()
into an untrusted document from chrome, even using wrappedJSObject
. See Security check basics for more about principals.
Three-argument document.open()
There is a lesser-known and little-used three-argument version of document.open()
, which is an alias of Window.open()
(see its page for full details).
This call, for example opens github.com in a new window, with its opener set to null
:
document.open("https://www.github.com", "", "noopener=true");
Two-argument document.open()
Browsers used to support a two-argument document.open()
, with the following signature:
document.open(type, replace);
Where type
specified the MIME type of the data you are writing (e.g. text/html
) and replace if set (i.e. a string of "replace"
) specified that the history entry for the new document would replace the current history entry of the document being written to.
This form is now obsolete; it won't throw an error, but instead just forwards to document.open()
(i.e. is the equivalent of just running it with no arguments). The history-replacement behavior now always happens.
Especificaciones
Specification |
---|
HTML Standard # dom-document-open-dev |
Compatibilidad del Navegador
BCD tables only load in the browser