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.documentElementLeia 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.