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

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

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

Fontes