CKTIS / JavaScript
Document.body — достъп до елемента body на документа
Document.body е свойство на уеб API, достъпно като document.body. То връща елемент body, остарял елемент frameset или null. Присвояването заменя целия елемент, а не само съдържанието му.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
document.body
document.body = newBodyDocument.body е свойство на интерфейса Document, достъпно като document.body. То връща първия пряк дъщерен елемент на кореновия елемент на документа, който е елемент body или frameset в пространството от имена на HTML. Ако няма такъв дъщерен елемент, връща null. Не е необходимо самият коренов елемент да е елемент html. Свойството не връща текст или копие на елемента.
Преди да използвате резултата, имайте предвид, че той може да бъде null, например ако парсерът все още не е създал елемента body. Това е уеб API, дефиниран в HTML Standard, а не функционалност на самия ECMAScript. Версията на Node в хранилището не потвърждава наличието на този API на браузъра.
Присвояването document.body = newBody заменя съществуващия елемент и поддървото му; старото съдържание не се копира. Присвояването на същия елемент не променя нищо. Ако елементът body липсва, новият елемент се добавя към кореновия елемент. Липсващ коренов елемент или присвояване на null или елемент div предизвиква DOMException HierarchyRequestError: приемат се елементи body и frameset.
Примерът работи с отделен документ. Той показва замяната на елемента и отделянето на предишния, без да променя показваната страница.
Примери
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);Резултат
true After true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.