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 = newBodydocument.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