Document

Baseline

Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

* Some parts of this feature may have varying levels of support.

See full compatibility
Learn more

La interfaz Document representa cualquier página web cargada en el navegador y sirve como punto de entrada al contenido de la página web, que es el árbol DOM (Document Object Model).

El árbol DOM incluye elementos como <body> y <table>, entre muchos otros. Proporciona funcionalidad globalmente al documento, como obtener la URL de la página y crear nuevos elementos en el documento.

La interfaz Document describe las propiedades y métodos comunes para cualquier tipo de documento. Según el tipo de documento (p. ej., HTML, XML, SVG, etc.), hay disponible una API más grande: los documentos HTML, servidos con el tipo de contenido "text/html", también implementan la interfaz HTMLDocument , mientras que los documentos XML y SVG implementan la interfaz XMLDocument.

Constructor

Document(): Crea un nuevo objeto Document.

Propiedades

Esta interfaz también hereda de las interfaces Node y EventTarget.

Document.activeElement Read only: Devuelve el Element actualmente activo.
Document.body: Devuelve el nodo <body> o <frameset> del documento actual.
Document.characterSetRead only: Devuelve el conjunto de caracteres que utiliza el documento.
Document.childElementCount Read only: Devuelve el número de elementos hijos del documento actual.
Document.children Read only: Devuelve los elementos hijos del documento actual.
Document.compatMode Read only: Indica si el documento se representa en modo quirks o strict.
Document.contentType Read only: Devuelve el tipo de contenido del encabezado MIME del documento actual.
Document.currentScriptRead only: Devuelve el elemento <script> cuyo script se está procesando actualmente y no es un módulo de JavaScript.
Document.doctypeRead only: Devuelve la Definición de Tipo de Documento (DTD) del documento actual.
Document.documentElementRead only: Devuelve el Element que es un hijo directo del documento. Para documentos HTML, normalmente es el objeto HTMLHtmlElement que representa el elemento <html> del documento.
Document.documentURIRead only: Devuelve la ubicación del documento como una cadena.
Document.embedsRead only: Devuelve un HTMLCollection de los elementos <embed> incrustados en el documento.
Document.firstElementChild Read only: Devuelve el primer elemento hijo del documento actual.
Document.fonts: Devuelve la interfaz FontFaceSet del documento actual.
Document.formsRead only: Devuelve un HTMLCollection de los elementos <form> del documento.
Document.fullscreenElement Read only: El elemento que está actualmente en modo de pantalla completa para este documento.
Document.headRead only: Devuelve el elemento <head> del documento actual.
Document.hiddenRead only: Devuelve un valor booleano que indica si la página se considera oculta o no.
Document.imagesRead only: Devuelve un HTMLCollection de las imágenes del documento.
Document.implementationRead only: Devuelve la implementación DOM asociada con el documento actual.
Document.lastElementChild Read only: Devuelve el último elemento hijo del documento actual.
Document.linksRead only: Devuelve un HTMLCollection de los hipervínculos del documento.
Document.mozSyntheticDocument: Devuelve true solo si este documento es sintético, como una imagen independiente, video, archivo de audio o similar.
Document.pictureInPictureElement Read only: Devuelve el Element que se presenta actualmente en modo picture-in-picture en este documento.
Document.pictureInPictureEnabled Read only: Devuelve true si la función picture-in-picture está habilitada.
Document.pluginsRead only: Devuelve un HTMLCollection de los complementos disponibles.
Document.pointerLockElement Read only: Devuelve el conjunto de elementos como destino para los eventos del mouse mientras el puntero está bloqueado. null si el bloqueo está pendiente, el puntero está desbloqueado o si el objetivo está en otro documento.
Document.featurePolicy Read only: Devuelve la interfaz FeaturePolicy que proporciona una API simple para analizar las políticas de funciones aplicadas a un documento específico.
Document.scriptsRead only: Devuelve un HTMLCollection de los elementos <script> del documento.
Document.scrollingElementRead only: Devuelve una referencia al Element que desplaza el documento.
Document.styleSheets Read only: Devuelve un objeto StyleSheetList de CSSStyleSheet para hojas de estilo explícitamente vinculadas o incrustadas en un documento.
Document.timeline Read only: Devuelve la línea de tiempo como una instancia especial de DocumentTimeline que se crea automáticamente al cargar la página.
Document.visibilityStateRead only: Devuelve un string que indica el estado de visibilidad del documento. Los valores posibles son visible, hidden, prerender y unloaded.

Extensiones para HTMLDocument

La interfaz Document para documentos HTML hereda de la interfaz HTMLDocument o, desde HTML5, se amplía para dichos documentos.

Document.cookie: Devuelve una lista separada por punto y coma de las cookies para ese documento o establece una sola cookie.
Document.defaultViewRead only: Devuelve una referencia al objeto de la ventana.
Document.designMode: Establece u obtiene la capacidad de editar todo el documento.
Document.dir: Establece u obtiene la direccionalidad (rtl/ltr) del documento.
Document.domain: Establece u obtiene el dominio del documento actual.
Document.lastModifiedRead only: Devuelve la fecha en la que se modificó por última vez el documento.
Document.locationRead only: Devuelve la URI del documento actual.
Document.readyStateRead only: Devuelve el estado de carga del documento.
Document.referrerRead only: Devuelve el URI de la página que se vinculó a esta página.
Document.title: Establece u obtiene el título del documento actual.
Document.URLRead only: Devuelve la ubicación del documento como una cadena.

Manejadores de eventos

La interfaz Document se amplía con manejadores de eventos adicionales definidos en GlobalEventHandlers.

Document.onafterscriptexecute: Representa el código del manejador de eventos para el evento afterscriptexecute.
Document.onbeforescriptexecute: Representa el código del manejador de eventos para el evento beforescriptexecute.
Document.onreadystatechange: Representa el código del manejador de eventos para el evento readystatechange.
GlobalEventHandlers.onselectionchange: Es un manejador de eventos que representa el código que se llamará cuando se genere el evento selectionchange.
Document.onvisibilitychange: Es un manejador de eventos que representa el código que se llamará cuando se genere el evento visibilitychange.

Propiedades obsoletas

Document.alinkColor: Devuelve o establece el color de los enlaces activos en el cuerpo del documento.
Document.all: Proporciona acceso a todos los elementos del documento; devuelve un HTMLAllCollection arraigado en el nodo del documento. Esta es una propiedad heredada, no estándar y no debe usarse.
Document.anchors Read only: Devuelve una lista de todos los anclajes en el documento.
Document.applets Read only: Devuelve una lista ordenada de los subprogramas dentro de un documento.
Document.bgColor: Establece u obtiene el color de fondo del documento actual.
Document.charset Read only: Alias de Document.characterSet. Utilice esta propiedad en su lugar.
Document.fgColor: Establece u obtiene el color de primer plano o el color del texto del documento actual.
Document.fullscreen: Devuelve true cuando el documento está en modo pantalla completa.
Document.height: Establece u obtiene la altura del documento actual.
Document.inputEncoding Read only: Alias de Document.characterSet. Utilice esta propiedad en su lugar.
Document.lastStyleSheetSet Read only: Devuelve el nombre del conjunto de hojas de estilo que se habilitó por última vez. Tiene el valor null hasta que se cambia la hoja de estilo estableciendo el valor de selectedStyleSheetSet.
Document.linkColor: Establece u obtiene el color de los hipervínculos en el documento.
Document.preferredStyleSheetSet Read only: Devuelve el conjunto de hojas de estilo preferido según lo especificado por el autor de la página.
Document.rootElement: Como Document.documentElement, pero solo para elementos <svg> raíz. Utilice esta propiedad en su lugar.
Document.selectedStyleSheetSet: Devuelve qué conjunto de hojas de estilo está actualmente en uso.
Document.styleSheetSets Read only: Devuelve una lista de los conjuntos de hojas de estilo disponibles en el documento.
Document.vlinkColor: Establece u obtiene el color de los hipervínculos visitados.
Document.width: Devuelve el ancho del documento actual.
Document.xmlEncoding: Devuelve la codificación determinada por la declaración XML.
Document.xmlStandalone: Devuelve true si la declaración XML especifica que el documento sea independiente (p. ej., Una parte externa de la DTD afecta el contenido del documento), de lo contrario, false.
Document.xmlVersion: Devuelve el número de versión como se especifica en la declaración XML o "1.0" si la declaración está ausente.

Métodos

Esta interfaz también hereda de las interfaces Node y EventTarget.

Document.adoptNode(): Adopta un nodo de un documento externo.
Document.append(): Inserta un conjunto de objetos Node u objetos String después del último elemento hijo del documento.
Document.captureEvents(): Consulte Window.captureEvents.
Document.caretPositionFromPoint(): Devuelve un objeto CaretPosition que contiene el nodo DOM que contiene el signo de intercalación y el desplazamiento del carácter del signo de intercalación dentro de ese nodo.
Document.caretRangeFromPoint(): Obtiene un objeto Range para el fragmento de documento bajo las coordenadas especificadas.
Document.createAttribute(): Crea un nuevo objeto Attr y lo devuelve.
Document.createAttributeNS(): Crea un nuevo nodo de atributo en un espacio de nombres determinado y lo devuelve.