CKTIS / JavaScript
Document.body – dostop do elementa body dokumenta
Document.body je lastnost spletnega API-ja, dostopna kot document.body. Vrne element body, zastareli element frameset ali null. Dodelitev zamenja celoten element, ne le njegove vsebine.
Različica: 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 lastnost vmesnika Document, dostopna kot document.body. Vrne prvi neposredni podrejeni element korenskega elementa dokumenta, ki je element body ali frameset v imenskem prostoru HTML. Če takega podrejenega elementa ni, vrne null. Ni nujno, da je korenski element sam element html. Ne vrne besedila ali kopije elementa.
Pred uporabo upoštevajte možnost, da je rezultat null, na primer če razčlenjevalnik še ni ustvaril elementa body. To je spletni API, določen v HTML Standard, in ne funkcija samega ECMAScripta. Različica Node v repozitoriju ne potrjuje, da je ta brskalniški API na voljo.
Dodelitev document.body = newBody zamenja obstoječi element in njegovo poddrevo; stare vsebine ne kopira. Dodelitev istega elementa ne povzroči sprememb. Če element body manjka, se novi element doda korenskemu elementu. Če manjka korenski element ali se dodeli null oziroma element div, pride do izjeme DOMException HierarchyRequestError: sprejeti so elementi body in frameset.
Primer deluje z ločenim dokumentom. Prikazuje zamenjavo elementa in odklop prejšnjega, ne da bi spremenil prikazano stran.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.