Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Document.body — dostęp do elementu treści dokumentu

Document.body to właściwość Web API odczytywana jako document.body. Zwraca element body, historyczny frameset albo null. Przypisanie zastępuje cały element, a nie tylko jego zawartość.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

document.body
document.body = newBody

Document.body jest właściwością interfejsu Document, używaną jako document.body. Zwraca pierwszy spośród bezpośrednich elementów potomnych elementu głównego dokumentu, który jest elementem body lub frameset w przestrzeni nazw HTML. Jeśli nie ma takiego elementu potomnego, zwraca null. Sam element główny nie musi być elementem html. Nie zwraca tekstu ani kopii elementu.

Przed użyciem sprawdź możliwość wystąpienia null, na przykład gdy parser nie utworzył jeszcze elementu body. To Web API określone w HTML Standard, a nie funkcja samego ECMAScript. Wersja Node w repozytorium nie potwierdza dostępności tego API przeglądarki.

Przypisanie document.body = newBody zastępuje istniejący element wraz z jego poddrzewem; nie kopiuje starej zawartości. Przypisanie tego samego elementu nic nie zmienia. Jeśli brakuje elementu treści, nowy jest dołączany do elementu głównego. Brak elementu głównego albo przypisanie null lub elementu div powoduje HierarchyRequestError typu DOMException: akceptowane są elementy body i frameset.

Przykład działa na osobnym dokumencie. Pokazuje zastąpienie elementu i odłączenie poprzedniego, bez zmiany wyświetlanej strony.

Przykłady

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);

Wynik

true
After
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła