WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

`document.getElementById()` und `document.body` im Vergleich

Mit `getElementById()` findest du ein Element anhand seiner ID. Mit `document.body` greifst du unabhängig von einer ID auf das Body-Element des Dokuments zu.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

document.getElementById(id)
document.body
document.body = newBody

document.getElementById(id) durchsucht den Baum des jeweiligen Dokuments und gibt ein Element oder null zurück. Übergib den genauen Wert von id, etwa "note", und keinen CSS-Selektor wie "#note". Groß- und Kleinschreibung werden unterschieden. IDs sollten eindeutig sein; bei Duplikaten zählt der erste Treffer in Baumreihenfolge. Noch nicht in den Dokumentbaum eingefügte Elemente werden nicht gefunden.

document.body liest du ohne Klammern. Die Eigenschaft liefert das erste direkte Kind des HTML-Wurzelelements html, das ein HTML-Element body oder ein veraltetes HTML-Element frameset ist, sonst null. document.getElementById("body") sucht nach der ID body, nicht nach dem Tag. Es kann also ein anderes Element oder null zurückgeben, obwohl document.body vorhanden ist.

Eine Zuweisung an document.body kann den bestehenden Body-Knoten mitsamt seinem Teilbaum ersetzen. Gibt es noch keinen Body, wird das neue Element an das Dokumentelement angehängt. Bei null, einem Element, das kein HTML-Element body oder frameset ist, oder einem fehlenden Dokumentelement wird eine DOMException namens HierarchyRequestError ausgelöst.

Während des Parsens kann null bedeuten, dass der Knoten noch nicht erzeugt wurde. Greife bei statischem HTML erst nach dem Parsen darauf zu, etwa in einem vor dem Ereignis registrierten DOMContentLoaded-Handler. Prüfe das Ergebnis trotzdem vor der Verwendung. Diese APIs gehören zur Webplattform, nicht zu ECMAScript 2024; ein gewöhnlicher Web Worker kann nicht auf das document der Seite zugreifen.

Beispiele

<!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>

Ergebnis

Before setting an ID: null
Same node: true
Wrong case: null
Before insertion: null
After insertion: true

Speichere das Beispiel als `.html`-Datei, öffne sie im Browser und prüfe die Meldungen in der Browserkonsole. Das separate Dokument enthält bereits ein `body`-Element, zunächst ohne ID. Nach Vergabe der ID liefern beide Zugriffsformen denselben Knoten. Das `p`-Element wird erst nach dem Einfügen gefunden.

Zugehörige Lektionen

  • JavaScript · Lektion 6 · Fortgeschritten · Version: 4

Quellen