CKTIS / JavaScript
Document.documentElement — l’élément racine du document
Document.documentElement renvoie l’élément racine du document ou null. Cette propriété est en lecture seule, mais l’élément lui-même peut être modifié.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.documentElementLisez Document.documentElement sur une instance de Document, par exemple avec document.documentElement. La propriété renvoie l’Element dont le parent est le document, ou null si aucun élément de ce type n’existe. Un document peut avoir au plus un tel élément.
L’analyseur HTML crée normalement un élément html comme racine du document, mais le DOM n’impose pas ce nom de balise. Si vous remplacez la racine par un autre élément, par exemple body, la propriété renvoie ce nouvel élément. En XML, son nom dépend du document. Ne confondez pas cette propriété avec firstChild, qui peut plutôt désigner, par exemple, une déclaration de type de document.
Le fait qu’une propriété soit en lecture seule ne signifie pas que l’élément renvoyé est immuable. L’exemple supprime la racine d’un document XML distinct ; la lecture suivante renvoie null. Il s’agit d’une API DOM, et non d’une fonctionnalité du langage ECMAScript.
Exemples
const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);Résultat
root null
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.