Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Document.documentElement — el elemento raíz del documento

Document.documentElement devuelve el elemento raíz del documento o null. La propiedad es de solo lectura, pero el elemento en sí se puede modificar.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

document.documentElement

Lee Document.documentElement en una instancia de Document, por ejemplo, con document.documentElement. Devuelve el Element cuyo padre es el documento, o null si no existe ninguno. Un documento puede tener como máximo un elemento de este tipo.

El analizador de HTML normalmente crea un elemento html como raíz del documento, pero el DOM no exige ese nombre de etiqueta. Si sustituyes la raíz por otro elemento, como body, la propiedad devuelve el nuevo elemento. En XML, su nombre depende del documento. No confundas esta propiedad con firstChild, que puede hacer referencia, por ejemplo, a una declaración de tipo de documento.

Que la propiedad sea de solo lectura no significa que el elemento devuelto sea inmutable. El ejemplo elimina la raíz de un documento XML independiente; la siguiente lectura devuelve null. Esta es una API del DOM, no una característica del lenguaje ECMAScript.

Ejemplos

const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);

Resultado

root
null

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes