KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Document.documentElement — het root-element van het document

Document.documentElement geeft het root-element van het document of null terug. De eigenschap is alleen-lezen, maar het element zelf kan wel worden aangepast.

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

Syntax

document.documentElement

Lees Document.documentElement uit op een instantie van Document, bijvoorbeeld met document.documentElement. De eigenschap geeft het Element terug waarvan het document de ouder is, of null als zo’n element niet bestaat. Een document kan maximaal één dergelijk element hebben.

De HTML-parser maakt normaal gesproken een html-element aan als root-element van het document, maar het DOM schrijft die tagnaam niet voor. Vervang je het root-element door een ander element, zoals body, dan geeft de eigenschap het nieuwe element terug. In XML hangt de naam af van het document. Verwar deze eigenschap niet met firstChild, dat bijvoorbeeld naar een documenttypedeclaratie kan verwijzen.

Dat de eigenschap alleen-lezen is, betekent niet dat het teruggegeven element onveranderlijk is. Het voorbeeld verwijdert de root van een apart XML-document; bij de volgende uitlezing wordt null teruggegeven. Dit is een DOM-API, geen functie van de ECMAScript-taal.

Voorbeelden

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

Resultaat

root
null

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen