Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Document.body

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨maio de 2018⁩.

Retorna o elemento <body> ou o <frameset> do documento atual, ou null se nenhum destes elementos existir.

Sintaxe

var objRef = document.body;
document.body = objRef;

Exemplo

js
// No HTML: <body id="oldBodyElement"></body>
alert(document.body.id); // "oldBodyElement"

var aNewBodyElement = document.createElement("body");

aNewBodyElement.id = "newBodyElement";
document.body = aNewBodyElement;
alert(document.body.id); // "newBodyElement"

Notas

document.body é o elemento que envolve o conteúdo do documento. Em documentos com conteúdo no <body>, retorna o elemento <body>, e em documentos que usam frameset, retorna o elemento <frameset> mais periférico.

Apesar do body ser configurável, definir um novo body em um documento irá remover todos os elementos contidos no elemento <body> existente.

Especificação

Veja Também