Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Document.body — aceder ao elemento body do documento

Document.body é uma propriedade da Web API acedida como document.body. Devolve um elemento body, um elemento frameset legado ou null. A atribuição substitui o elemento inteiro, não apenas o seu conteúdo.

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

Sintaxe

document.body
document.body = newBody

Document.body é uma propriedade da interface Document, acedida como document.body. Devolve o primeiro filho direto do elemento raiz do documento que seja um elemento body ou frameset no espaço de nomes HTML. Se nenhum filho satisfizer essa condição, devolve null. O próprio elemento raiz não tem de ser um elemento html. Não devolve texto nem uma cópia do elemento.

Antes de utilizar o resultado, tenha em conta que pode ser null, por exemplo, se o analisador ainda não tiver criado o elemento body. Esta é uma Web API definida pelo HTML Standard, não uma funcionalidade do próprio ECMAScript. A versão de Node no repositório não comprova a disponibilidade desta API do navegador.

A atribuição document.body = newBody substitui o elemento existente e a respetiva subárvore; não copia o conteúdo antigo. Atribuir o mesmo elemento não altera nada. Se o elemento body não existir, o novo elemento é anexado ao elemento raiz. A ausência do elemento raiz, ou a atribuição de null ou de um elemento div, provoca uma DOMException HierarchyRequestError: são aceites elementos body e frameset.

O exemplo utiliza um documento separado. Demonstra a substituição do elemento e a separação do anterior sem alterar a página apresentada.

Exemplos

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

Resultado

true
After
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes