Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources