Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 = newBody

Document.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.

Zdroje