База знанияИзпитен център
BGБългарски
Избери език13

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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници