Document.open()

This translation is incomplete. Please help translate this article from English

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

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.

Specifications

Specification Status Comment
HTML Living Standard
La definición de 'document.open()' en esta especificación.
Living Standard
Document Object Model (DOM) Level 2 HTML Specification
La definición de 'document.open()' en esta especificación.
Obsolete

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome para AndroidFirefox para AndroidOpera para AndroidSafari en iOSSamsung Internet
openChrome Soporte completo 45
Notas
Soporte completo 45
Notas
Notas Before Chrome 64, this method was accessed through the HTMLDocument alias.
Edge Soporte completo 12Firefox Soporte completo 1IE Soporte completo 4Opera Soporte completo ≤12.1Safari Soporte completo 1WebView Android Soporte completo 45
Notas
Soporte completo 45
Notas
Notas Before Chrome 64, this method was accessed through the HTMLDocument alias.
Chrome Android Soporte completo 45
Notas
Soporte completo 45
Notas
Notas Before Chrome 64, this method was accessed through the HTMLDocument alias.
Firefox Android Soporte completo 4Opera Android Soporte completo ≤12.1Safari iOS Soporte completo 1Samsung Internet Android Soporte completo 5.0
Notas
Soporte completo 5.0
Notas
Notas Before Samsung Internet 9.0, this method was accessed through the HTMLDocument alias.

Leyenda

Soporte completo  
Soporte completo
Ver notas de implementación.
Ver notas de implementación.

See also