CKTIS / JavaScript
`document.getElementById()` e `document.body`: qual é a diferença?
Usa `getElementById()` para procurar um elemento pelo identificador e `document.body` para aceder ao corpo do documento, com ou sem identificador.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
document.getElementById(id)
document.body
document.body = newBodydocument.getElementById(id) procura na árvore desse documento e devolve um Element ou null. Passa o valor exato de id, por exemplo "note", e não um seletor CSS como "#note". A procura distingue maiúsculas de minúsculas. Os identificadores devem ser únicos; se houver duplicados, é devolvida a primeira correspondência na ordem da árvore. Os elementos que ainda não foram inseridos na árvore não são encontrados.
Lê document.body sem parênteses. A propriedade devolve o primeiro filho direto do elemento HTML raiz html que seja um elemento HTML body ou um elemento HTML obsoleto frameset, ou null se não houver nenhum. document.getElementById("body") procura o identificador body, não a etiqueta. Pode devolver outro elemento ou null, mesmo quando document.body existe.
Uma atribuição a document.body pode substituir todo o nó do corpo e a respetiva subárvore. Se não houver corpo, o novo elemento é acrescentado ao elemento raiz do documento. Atribuir null ou um elemento que não seja um elemento HTML body ou frameset, ou fazer a atribuição quando não há elemento raiz, lança uma DOMException com o nome HierarchyRequestError.
Durante a análise da página, null pode indicar que o nó ainda não foi criado. Em HTML estático, acede ao nó após a análise, por exemplo num gestor de DOMContentLoaded registado antes do evento, e verifica sempre o resultado antes de o usares. Estas API pertencem à plataforma Web, não ao ECMAScript 2024; um web worker normal não consegue aceder ao document da página.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM lookup example</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument("DOM demo");
const body = doc.body;
console.log(`Before setting an ID: ${doc.getElementById("body")}`);
body.id = "body";
console.log(`Same node: ${doc.getElementById("body") === body}`);
console.log(`Wrong case: ${doc.getElementById("Body")}`);
const item = doc.createElement("p");
item.id = "note";
console.log(`Before insertion: ${doc.getElementById("note")}`);
body.appendChild(item);
console.log(`After insertion: ${doc.getElementById("note") === item}`);
})();
</script>
</body>
</html>Resultado
Before setting an ID: null Same node: true Wrong case: null Before insertion: null After insertion: true
Guarda o exemplo num ficheiro `.html`, abre-o num navegador e verifica as mensagens na consola. O documento separado já tem um elemento `body`, mas sem identificador. Depois de lhe atribuíres um identificador, as duas formas de acesso devolvem o mesmo nó. O elemento `p` só é encontrado depois de ser inserido.
Lições relacionadas
- JavaScript · Lição 6 · Avançado · Versão: 4