KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Document.body — toegang tot het body-element van het document

Document.body is een Web API-eigenschap die je gebruikt als document.body. De eigenschap retourneert een body-element, een verouderd frameset-element of null. Toewijzing vervangt het volledige element, niet alleen de inhoud ervan.

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.body
document.body = newBody

Document.body is een eigenschap van de interface Document en wordt gebruikt als document.body. De eigenschap retourneert het eerste directe kindelement van het root-element van het document dat een body- of frameset-element in de HTML-naamruimte is. Als er geen dergelijk kindelement is, retourneert de eigenschap null. Het root-element zelf hoeft geen html-element te zijn. De eigenschap retourneert geen tekst of kopie van het element.

Houd vóór gebruik rekening met de mogelijkheid van null, bijvoorbeeld wanneer de parser het body-element nog niet heeft aangemaakt. Dit is een Web API die is gedefinieerd in de HTML Standard, geen functie van ECMAScript zelf. De Node-versie in de repository bewijst niet dat deze browser-API beschikbaar is.

Met document.body = newBody vervang je het bestaande element en de bijbehorende substructuur; de oude inhoud wordt niet gekopieerd. Hetzelfde element toewijzen verandert niets. Als het body-element ontbreekt, wordt het nieuwe element aan het root-element toegevoegd. Als het root-element ontbreekt, of als je null of een div-element toewijst, ontstaat een HierarchyRequestError-DOMException: body- en frameset-elementen worden geaccepteerd.

Het voorbeeld werkt met een afzonderlijk document. Het laat zien hoe je het element vervangt en het vorige loskoppelt zonder de weergegeven pagina te wijzigen.

Voorbeelden

const doc = document.implementation.createHTMLDocument("");
const original = doc.body;
original.textContent = "Before";

const replacement = doc.createElement("body");
replacement.textContent = "After";
doc.body = replacement;

console.log(doc.body === replacement);
console.log(doc.body.textContent);
console.log(original.parentNode === null);

Resultaat

true
After
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