Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Document.documentElement — o elemento raiz do documento

Document.documentElement devolve o elemento raiz do documento ou null. A propriedade é só de leitura, mas o próprio elemento pode ser modificado.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

document.documentElement

Leia Document.documentElement numa instância de Document, por exemplo, através de document.documentElement. Devolve o Element cujo pai é o documento, ou null se não existir nenhum elemento desse tipo. Um documento pode ter, no máximo, um elemento assim.

O analisador de HTML cria normalmente um elemento html como raiz do documento, mas o DOM não exige esse nome de etiqueta. Se substituir a raiz por outro elemento, como body, a propriedade devolve o novo elemento. Em XML, o nome depende do documento. Não confunda esta propriedade com firstChild, que pode apontar, por exemplo, para uma declaração de tipo de documento.

O facto de a propriedade ser só de leitura não significa que o elemento devolvido seja imutável. O exemplo remove a raiz de um documento XML separado; a leitura seguinte devolve null. Esta é uma API DOM, não uma funcionalidade da linguagem ECMAScript.

Exemplos

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

Resultado

root
null

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes