CKTIS / JavaScript
Document.body – přístup k prvku body dokumentu
Document.body je vlastnost webového API přístupná jako document.body. Vrací prvek body, zastaralý prvek frameset, nebo null. Přiřazení nahradí celý prvek, nejen jeho obsah.
Verze: 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.body
document.body = newBodyDocument.body je vlastnost rozhraní Document, přístupná jako document.body. Vrací první přímý podřízený prvek kořenového prvku dokumentu, který je prvkem body nebo frameset ve jmenném prostoru HTML. Pokud takový podřízený prvek neexistuje, vrací null. Samotný kořenový prvek nemusí být prvkem html. Nevrací text ani kopii prvku.
Před použitím počítejte s možností, že výsledek bude null, například pokud parser ještě nevytvořil prvek body. Jde o webové API definované v HTML Standard, nikoli o součást samotného ECMAScriptu. Verze Node v repozitáři nepotvrzuje dostupnost tohoto API prohlížeče.
Přiřazení document.body = newBody nahradí existující prvek i jeho podstrom; starý obsah se nekopíruje. Přiřazení stejného prvku nic nezmění. Pokud prvek body chybí, nový prvek se připojí ke kořenovému prvku. Chybějící kořenový prvek nebo přiřazení null či prvku div způsobí DOMException HierarchyRequestError: přijímány jsou prvky body a frameset.
Příklad pracuje se samostatným dokumentem. Ukazuje nahrazení prvku a odpojení předchozího, aniž by se změnila zobrazená stránka.
Příklady
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);Výsledek
true After true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.