Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.

View in EnglishAlways switch to English

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.

La interfazDocument 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>, entremuchos otros. Proporciona funcionalidad globalmente al documento, como obtener la URL de la página y crear nuevos elementos en el documento.

La interfazDocument 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 interfazHTMLDocument , mientras que los documentos XML y SVG implementan la interfazXMLDocument.

Constructor

Document(): Crea un nuevo objetoDocument.

Propiedades

Esta interfaz también hereda de las interfacesNode yEventTarget.

Document.activeElementRead only: Devuelve elElement 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.childElementCountRead only: Devuelve el número de elementos hijos del documento actual.
Document.childrenRead only: Devuelve los elementos hijos del documento actual.
Document.compatModeExperimentalRead only: Indica si el documento se representa en modo quirks ostrict.
Document.contentTypeExperimentalRead 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 yno 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 elElement que es un hijo directo del documento. Para documentos HTML, normalmente es el objetoHTMLHtmlElement que representa el elemento<html> del documento.
Document.documentURIRead only: Devuelve la ubicación del documento como una cadena.
Document.embedsRead only: Devuelve unHTMLCollection de los elementos<embed> incrustados en el documento.
Document.firstElementChildRead only: Devuelve el primer elemento hijo del documento actual.
Document.fonts: Devuelve la interfazFontFaceSet del documento actual.
Document.formsRead only: Devuelve unHTMLCollection de los elementos<form> del documento.
Document.fullscreenElementRead 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 unHTMLCollection de las imágenes del documento.
Document.implementationRead only: Devuelve la implementación DOM asociada con el documento actual.
Document.lastElementChildRead only: Devuelve el último elemento hijo del documento actual.
Document.linksRead only: Devuelve unHTMLCollection de los hipervínculos del documento.
Document.mozSyntheticDocumentNo estándar: Devuelvetrue solo si este documento es sintético, como una imagen independiente, video, archivo de audio o similar.
Document.pictureInPictureElementRead only: Devuelve elElement que se presenta actualmente en modopicture-in-picture en este documento.
Document.pictureInPictureEnabledRead only: Devuelvetrue si la funciónpicture-in-picture está habilitada.
Document.pluginsRead only: Devuelve unHTMLCollection de los complementos disponibles.
Document.pointerLockElementRead 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.featurePolicyExperimentalRead 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 unHTMLCollection de los elementos<script> del documento.
Document.scrollingElementRead only: Devuelve una referencia alElement que desplaza el documento.
Document.styleSheetsRead only: Devuelve un objetoStyleSheetList deCSSStyleSheet para hojas de estilo explícitamente vinculadas o incrustadas en un documento.
Document.timelineExperimentalRead 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 unstring que indica el estado de visibilidad del documento. Los valores posibles sonvisible,hidden,prerender yunloaded.

Extensiones para HTMLDocument

La interfazDocument para documentos HTML hereda de la interfazHTMLDocument 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.domainObsoleto: 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 interfazDocument se amplía con manejadores de eventos adicionales definidos enGlobalEventHandlers.

Document.onafterscriptexecuteNo estándar: Representa el código del manejador de eventos para el evento afterscriptexecute.
Document.onbeforescriptexecuteNo estándar: Representa el código del manejador de eventos para el evento beforescriptexecute.
Document.onreadystatechange: Representa el código del manejador de eventos para el eventoreadystatechange.
GlobalEventHandlers.onselectionchangeExperimental: Es un manejador de eventos que representa el código que se llamará cuando se genere el eventoselectionchange.
Document.onvisibilitychange: Es unmanejador de eventos que representa el código que se llamará cuando se genere el eventovisibilitychange.

Propiedades obsoletas

Document.alinkColorObsoleto: Devuelve o establece el color de los enlaces activos en el cuerpo del documento.
Document.allObsoleto No estándar: 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.anchorsObsoletoRead only: Devuelve una lista de todos los anclajes en el documento.
Document.appletsObsoletoRead only: Devuelve una lista ordenada de los subprogramas dentro de un documento.
Document.bgColorObsoleto: Establece u obtiene el color de fondo del documento actual.
Document.charsetObsoletoRead only: Alias de Document.characterSet. Utilice esta propiedad en su lugar.
Document.fgColorObsoleto: Establece u obtiene el color de primer plano o el color del texto del documento actual.
Document.fullscreenObsoleto: Devuelvetrue cuando el documento está en modo pantalla completa.
Document.heightNo estándar Obsoleto: Establece u obtiene la altura del documento actual.
Document.inputEncodingObsoletoRead only: Alias de Document.characterSet. Utilice esta propiedad en su lugar.
Document.lastStyleSheetSetObsoletoRead only: Devuelve el nombre del conjunto de hojas de estilo que se habilitó por última vez. Tiene el valornull hasta que se cambia la hoja de estilo estableciendo el valor de selectedStyleSheetSet.
Document.linkColorObsoleto: Establece u obtiene el color de los hipervínculos en el documento.
Document.preferredStyleSheetSetObsoletoRead only: Devuelve el conjunto de hojas de estilo preferido según lo especificado por el autor de la página.
Document.rootElementObsoleto: Como Document.documentElement, pero solo para elementos<svg> raíz. Utilice esta propiedad en su lugar.
Document.selectedStyleSheetSetObsoleto: Devuelve qué conjunto de hojas de estilo está actualmente en uso.
Document.styleSheetSetsObsoletoRead only: Devuelve una lista de los conjuntos de hojas de estilo disponibles en el documento.
Document.vlinkColorObsoleto: Establece u obtiene el color de los hipervínculos visitados.
Document.widthNo estándar Obsoleto: Devuelve el ancho del documento actual.
Document.xmlEncodingObsoleto: Devuelve la codificación determinada por la declaración XML.
Document.xmlStandaloneObsoleto: Devuelvetrue 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.xmlVersionObsoleto: 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 interfacesNode yEventTarget.

Document.adoptNode(): Adopta un nodo de un documento externo.
Document.append(): Inserta un conjunto de objetosNode u objetosDOMString después del último elemento hijo del documento.
Document.captureEvents()Obsoleto: Consulte Window.captureEvents.
Document.caretPositionFromPoint(): Devuelve un objetoCaretPosition 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()No estándar: Obtiene un objeto Range para el fragmento de documento bajo las coordenadas especificadas.
Document.createAttribute(): Crea un nuevo objetoAttr y lo devuelve.
Document.createAttributeNS(): Crea un nuevo nodo de atributo en un espacio de nombres determinado y lo devuelve.
Document.createCDATASection(): Crea un nuevo nodo CDATA y lo devuelve.
Document.createComment(): Crea un nuevo nodo de comentario y lo devuelve.
Document.createDocumentFragment(): Crea un nuevo fragmento de documento.
Document.createElement(): Crea un nuevo elemento con el nombre de etiqueta dado.
Document.createElementNS(): Crea un nuevo elemento con el nombre de etiqueta y el URI de espacio de nombres dados.
Document.createEntityReference()Obsoleto: Crea un nuevo objeto de referencia de entidad y lo devuelve.
Document.createEvent(): Crea un objeto de evento.
Document.createNodeIterator(): Crea un objetoNodeIterator.
Document.createProcessingInstruction(): Crea un nuevo objetoProcessingInstruction.
Document.createRange(): Crea un objetoRange.
Document.createTextNode(): Crea un nodo de texto.
Document.createTouch()Obsoleto: Crea un objeto Touch.
Document.createTouchList()Obsoleto: Crea un objeto TouchList.
Document.createTreeWalker(): Crea un objetoTreeWalker.
Document.elementFromPoint(): Devuelve el elemento superior en las coordenadas especificadas.
Document.elementsFromPoint(): Devuelve una matriz de todos los elementos en las coordenadas especificadas.
Document.enableStyleSheetsForSet()Obsoleto: Habilita las hojas de estilo para el conjunto de hojas de estilo especificado.
Document.exitPictureInPicture(): Retira el video de la ventana flotante depicture-in-picture y vuelve a su contenedor original.
Document.exitPointerLock()Experimental: Libera el bloqueo del puntero.
Document.getAnimations(): Devuelve una matriz de todos los objetosAnimation actualmente en uso, cuyos elementos de destino son descendientes dedocument.
Document.getBoxQuads()Experimental: Devuelve una lista de objetos DOMQuad que representan los fragmentos CSS del nodo.
Document.getElementById(): Devuelve una referencia de objeto al elemento identificado.
Document.getElementsByClassName(): Devuelve una lista de elementos con el nombre de clase dado.
Document.getElementsByTagName(): Devuelve una lista de elementos con el nombre de etiqueta dado.
Document.getElementsByTagNameNS(): Devuelve una lista de elementos con el nombre de etiqueta y el espacio de nombres dados.
Document.getSelection(): Devuelve un objetoSelection que representa el rango de texto seleccionado por el usuario o la posición actual del signo de intercalación.
Document.hasStorageAccess()Experimental: Devuelve un Promise que se resuelve con un valor booleano que indica si el documento tiene acceso a su almacenamiento propio.
Document.importNode(): Devuelve un clon de un nodo de un documento externo.
Document.normalizeDocument()Obsoleto: Reemplaza entidades, normaliza nodos de texto, etc.
Document.prepend(): Inserta un conjunto de objetosNode u objetosDOMString antes del primer elemento hijo del documento.
Document.querySelector(): Devuelve el primer nodoElement dentro del documento, en el orden del documento, que coincide con los selectores especificados.
Document.querySelectorAll(): Devuelve una lista de todos los nodosElement dentro del documento que coinciden con los selectores especificados.
Document.releaseCapture()No estándar: Libera la captura actual del mouse si está en un elemento de este documento.
Document.releaseEvents()No estándar Obsoleto: Consulte Window.releaseEvents().
Document.replaceChildren(): Reemplaza los elementos hijos existentes de un documento con un nuevo conjunto específico de elementos hijos.
Document.requestStorageAccess(): Devuelve unPromise que resuelve si se otorgó el acceso al almacenamiento propio y lo rechaza si se denegó el acceso.
Document.mozSetImageElement()No estándar: Le permite cambiar el elemento que se utiliza como imagen de fondo para un ID de elemento específico.

La interfazDocument se amplía con la interfaz XPathEvaluator:

Document.createExpression(): Compila unaXPathExpression que luego se puede usar para (repetidas) evaluaciones.
Document.createNSResolver(): Crea un objetoXPathNSResolver.
Document.evaluate(): Evalúa una expresión XPath.

Extensión para documentos HTML

La interfazDocument para documentos HTML se hereda de la interfazHTMLDocument o, desde HTML5, se amplía para dichos documentos:

Document.clear()No estándar Obsoleto: En la mayoría de los navegadores modernos, incluidas las versiones recientes de Firefox e Internet Explorer, este método no hace nada.
Document.close(): Cierra el flujo de escritura en el documento.
Document.execCommand()Obsoleto: En un documento editable, ejecuta un comando de formato.
Document.getElementsByName(): Devuelve una lista de elementos con el nombre dado.
Document.hasFocus(): Devuelvetrue si el foco se encuentra actualmente en cualquier lugar dentro del documento especificado.
Document.open(): Abre un flujo de escritura para el documento.
Document.queryCommandEnabled()Obsoleto: Devuelvetrue si el comando de formato se puede ejecutar en el rango actual.
Document.queryCommandIndeterm()Obsoleto: Devuelvetrue si el comando de formato está en un estado indeterminado en el rango actual.
Document.queryCommandState()Obsoleto: Devuelvetrue si el comando de formato se ha ejecutado en el rango actual.
Document.queryCommandSupported()Obsoleto: Devuelvetrue si el comando de formato es compatible con el rango actual.
Document.queryCommandValue()Obsoleto: Devuelve el valor actual del rango actual para un comando de formato.
Document.write(): Escribe texto en un documento.
Document.writeln(): Escribe una línea de texto en un documento.

Eventos

Puede detectar estos eventos usandoaddEventListener() o asignando un detector de eventos a la propiedadoneventname de esta interfaz.

scroll: Se activa cuando se ha desplazado la vista del documento o un elemento. También disponible a través de la propiedadonscroll.
visibilitychange: Se activa cuando el contenido de una pestaña se vuelve visible o se oculta. También disponible a través de la propiedadonvisibilitychange.
wheel: Se activa cuando el usuario gira un botón de rueda en un dispositivo señalador (generalmente un mouse). También disponible a través de la propiedadonwheel.

Eventos de animación

animationcancel: Se activa cuando una animación aborta inesperadamente. También disponible a través de la propiedadonanimationcancel.
animationend: Se activa cuando una animación se ha completado normalmente. También disponible a través de la propiedadonanimationend.
animationiteration: Se activa cuando se completa una iteración de animación. También disponible a través de la propiedadonanimationiteration.
animationstart: Se activa cuando comienza una animación. También disponible a través de la propiedadonanimationstart.

Eventos del portapapeles

copy: Se activa cuando el usuario inicia una acción de copiar a través de la interfaz de usuario del navegador.
cut: Se activa cuando el usuario inicia una acción de cortar a través de la interfaz de usuario del navegador.
paste: Se activa cuando el usuario inicia una acción de pegar a través de la interfaz de usuario del navegador.

Eventos de arrastrar y soltar

drag: Se activa cada pocos cientos de milisegundos cuando el usuario arrastra un elemento o una selección de texto. También disponible a través de la propiedadondrag.
dragend: Se activa cuando finaliza una operación de arrastre (soltando un botón del mouse o presionando la tecla Escape). También disponible a través de la propiedadondragend.
dragenter: Se activa cuando un elemento arrastrado o una selección de texto ingresa en un destino de colocación válido. También disponible a través de la propiedadondragenter.
dragleave: Se activa cuando un elemento arrastrado o una selección de texto deja un destino de colocación válido. También disponible a través de la propiedadondragleave.
dragover: Se activa cuando se arrastra un elemento o una selección de texto sobre un destino de colocación válido (cada pocos cientos de milisegundos). También disponible a través de la propiedadondragover.
dragstart: Se activa cuando el usuario comienza a arrastrar un elemento o una selección de texto. También disponible a través de la propiedadondragstart.
drop: Se activa cuando un elemento o una selección de texto se coloca en un destino de colocación válido. También disponible a través de la propiedadondrop.

Eventos de pantalla completa

fullscreenchange: Se activa cuandoDocument pasa al modo depantalla completa o sale del mismo.
fullscreenerror: Se activa si se produce un error al intentar activar o desactivar el modo depantalla completa.

Eventos de teclado

keydown: Se activa cuando se presiona una tecla. También disponible a través de la propiedadonkeydown.
keypress: Se activa cuando se presiona una tecla que produce un valor de carácter. También disponible a través de la propiedadonkeypress.
keyup: Se activa cuando se suelta una tecla. También disponible a través de la propiedadonkeyup.

Eventos de carga y descarga

DOMContentLoaded: Se activa cuando el documento se ha cargado y analizado por completo, sin esperar a que las hojas de estilo, las imágenes y los submarcos terminen de cargarse.
readystatechange: Se activa cuando el atributoreadyState de un documento ha cambiado. También disponible a través de la propiedadonreadystatechange.

Eventos de puntero

gotpointercapture: Se activa cuando un elemento captura un puntero usandosetPointerCapture(). También disponible a través de la propiedadongotpointercapture.
lostpointercapture: Se activa cuando se suelta unpuntero capturado. También disponible a través de la propiedadonlostpointercapture.
pointercancel: Se activa cuando se cancela un evento de puntero. También disponible a través de la propiedadonpointercancel.
pointerdown: Se activa cuando un puntero se vuelve activo. También disponible a través de la propiedadonpointerdown.
pointerenter: Se activa cuando se mueve un puntero a los límites de laprueba de acierto de un elemento o uno de sus hijos. También disponible a través de la propiedadonpointerenter.
pointerleave: Se activa cuando un puntero se mueve fuera de los límites de laprueba de acierto de un elemento. También disponible a través de la propiedadonpointerleave.
pointerlockchange: Se activa cuando el puntero está bloqueado o desbloqueado. También disponible a través de la propiedadonpointerlockchange.
pointerlockerror: Se activa cuando falla el bloqueo del puntero. También disponible a través de la propiedadonpointerlockerror.
pointermove: Se activa cuando un puntero cambia de coordenadas. También disponible a través de la propiedadonpointermove.
pointerout: Se activa cuando un puntero se mueve fuera de los límites de laprueba de acierto de un elemento (entre otras razones). También disponible a través de la propiedadonpointerout.
pointerover: Se activa cuando se mueve un puntero a los límites de laprueba de acierto de un elemento. También disponible a través de la propiedadonpointerover.
pointerup: Se activa cuando un puntero ya no está activo. También disponible a través de la propiedadonpointerup.

Eventos de selección

selectionchange: Se activa cuando se cambia la selección de texto actual en un documento. También disponible a través de la propiedadonselectionchange.
selectstart: Se activa cuando el usuario comienza una nueva selección. También disponible a través de la propiedadonselectstart.

Eventos táctiles

touchcancel: Se activa cuando uno o más puntos de contacto se han interrumpido de una manera específica de la implementación (por ejemplo, se crean demasiados puntos de contacto). También disponible a través de la propiedadontouchcancel.
touchend: Se activa cuando uno o más puntos de contacto se eliminan de la superficie táctil. También disponible a través de la propiedadontouchend
touchmove: Se activa cuando uno o más puntos de contacto se mueven a lo largo de la superficie táctil. También disponible a través de la propiedadontouchmove
touchstart: Se activa cuando se colocan uno o más puntos de contacto en la superficie táctil. También disponible a través de la propiedadontouchstart

Eventos de transición

transitioncancel: Se activa cuando se cancela unatransición de CSS. También disponible a través de la propiedadontransitioncancel.
transitionend: Se activa cuando se completa unatransición de CSS. También disponible a través de la propiedadontransitionend.
transitionrun: Se activa cuando se crea por primera vez unatransición de CSS. También disponible a través de la propiedadontransitionrun.
transitionstart: Se activa cuando realmente ha comenzado unatransición de CSS. También disponible a través de la propiedadontransitionstart.

Extensiones no estándar No estándar

No estándar: Esta función no está estandarizada. No recomendamos usar funciones no estándar en producción, ya que tienen un soporte limitado en los navegadores y pueden cambiar o eliminarse. Sin embargo, pueden ser una alternativa adecuada en casos específicos donde no exista una opción estándar.

Notas de firefox

Firefox define algunos métodos no estándar:

Document.execCommandShowHelp()Obsoleto: Este método nunca hizo nada y siempre arrojaba una excepción, por lo que se eliminó en Gecko 14.0 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).
Document.getBoxObjectFor()Obsoleto: Utilice el método Element.getBoundingClientRect() en su lugar.
Document.loadOverlay()Obsoleto: Carga una superposición XUL dinámicamente. Esto solo funciona en documentos XUL.
Document.queryCommandText()Obsoleto: Este método nunca hizo nada más que generar una excepción y se eliminó en Gecko 14 (Firefox 14.0 / Thunderbird 14.0 / SeaMonkey 2.11).

Notas de Internet Explorer

Microsoft define algunos métodos no estándar:

Document.fileSize*No estándar Obsoleto: Devuelve el tamaño en bytes del documento. A partir de Internet Explorer 11, esa propiedad ya no se admite. Consulte MSDN.

Especificaciones

Specification
DOM # interface-document
HTML # the-document-object
CSSOM View Module # extensions-to-the-document-interface
Pointer Lock 2.0 # extensions-to-the-document-interface
Selection API # extensions-to-document-interface

Compatibilidad con navegadores

Véase también

Help improve MDN

Learn how to contribute

This page was last modified on20 jun 2025 byMDN contributors.

View this page on GitHub •Report a problem with this content

Movatterモバイル変換

Document

Help improve MDN