KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Document — toegang tot het document van een pagina

Document vertegenwoordigt een DOM-document. Met het object document kun je elementen zoeken, de documentroot lezen en pagina-eigenschappen voor titel, focus en zichtbaarheid gebruiken. Het is een interface van het webplatform en geen onderdeel van ECMAScript zelf.

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.getElementById(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)

Document vertegenwoordigt een DOM-document; in een paginascript verwijst document naar het huidige document. Het is noch window, noch het root-element. Dit is een interface van het webplatform: de beschikbaarheid van JavaScript alleen, ook in Node 24, bewijst niet dat de interface wordt ondersteund.

Document.getElementById(id) retourneert het eerste overeenkomende element in boomvolgorde of null. Geef de identifier zonder # door en controleer het resultaat voordat je het gebruikt. Document.documentElement verwijst naar het root-element of is null. Op een gebruikelijke HTML-pagina is dit het element html. Document.body levert het element body of frameset, maar kan null zijn, bijvoorbeeld voordat de parser het aanmaakt. Met Document.title kun je de documenttitel lezen of wijzigen.

Document.activeElement verwijst naar het element dat bij de focus hoort; dat hoeft geen tekstveld te zijn. Bevindt de focus zich in een ingesloten document of shadow tree, dan kan het respectievelijk verwijzen naar het insluitende element of de host, in plaats van naar het diepst geneste element. Document.hidden is een booleaanse waarde die aangeeft of het document verborgen is, niet of het geen focus heeft. Document.visibilitychange staat voor de gebeurtenis visibilitychange, niet voor een methode: handel deze af met document.addEventListener("visibilitychange", handler) en lees document.hidden in de handler.

Het voorbeeld maakt een afzonderlijk HTML-document aan en wijzigt daardoor de geopende pagina niet; het levert voorspelbare waarden op. Het test focus of zichtbaarheid niet, omdat die van de omgeving afhangen. De brondekking is beperkt: de opgegeven DOM Standard definieert de kern van Document, maar niet alle genoemde HTML-uitbreidingen voor titel, body, focus en zichtbaarheid. Minimale browserversies zijn hier niet vastgesteld.

Voorbeelden

const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);

console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);

Resultaat

html
body
Document demo
Hello, DOM
true

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