CKTIS / JavaScript
Document.body — pristup elementu body dokumenta
Document.body je svojstvo web API-ja kojem se pristupa kao document.body. Vraća element body, zastarjeli element frameset ili null. Dodjela zamjenjuje cijeli element, a ne samo njegov sadržaj.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.body
document.body = newBodyDocument.body je svojstvo sučelja Document kojem se pristupa kao document.body. Vraća prvi izravni podređeni element korijenskog elementa dokumenta koji je element body ili frameset u imenskom prostoru HTML-a. Ako takav podređeni element ne postoji, vraća null. Sam korijenski element ne mora biti element html. Ne vraća tekst ni kopiju elementa.
Prije upotrebe uzmite u obzir mogućnost da je rezultat null, primjerice ako parser još nije stvorio element body. Riječ je o web API-ju definiranom u HTML Standardu, a ne o značajci samog ECMAScripta. Verzija Nodea u repozitoriju ne potvrđuje dostupnost ovog API-ja preglednika.
Dodjela document.body = newBody zamjenjuje postojeći element i njegovo podstablo; stari se sadržaj ne kopira. Dodjela istog elementa ne mijenja ništa. Ako element body nedostaje, novi se element dodaje korijenskom elementu. Ako nedostaje korijenski element ili se dodijeli null odnosno element div, dolazi do iznimke DOMException HierarchyRequestError: prihvaćaju se elementi body i frameset.
Primjer radi s odvojenim dokumentom. Prikazuje zamjenu elementa i odvajanje prethodnog bez promjene prikazane stranice.
Primjeri
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);Rezultat
true After true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.