WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Elemente per ID finden und auf Wurzelelement und Body zugreifen

Mit `getElementById()` findest du ein Element per ID, mit `documentElement` erhältst du das Wurzelelement und mit `body` greifst du auf den HTML-Dokumentkörper zu. Alle drei können aus unterschiedlichen Gründen `null` liefern.

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

Syntax

doc.getElementById(id) // id: string; returns Element or null
 doc.documentElement // read-only; returns Element or null
 doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = newBody // assigns an HTML body or frameset element

doc.getElementById(id) durchsucht den Dokumentbaum von doc. Gib den genauen id-Wert ohne zusätzliches # an: Es ist kein CSS-Selektor, und Groß- und Kleinschreibung werden unterschieden. Die Methode liefert ein passendes Element oder null. IDs sollten eindeutig sein; bei Duplikaten zählt der erste Treffer in Baumreihenfolge. Die Suche erfasst keine vom Dokumentbaum getrennten Knoten und durchsucht keine Shadow-DOM-Bäume.

doc.documentElement ist schreibgeschützt und liefert das Wurzelelement (<html> in einem HTML-Dokument; in XML kann es ein anderes Element sein) oder null, falls keines existiert. doc.body liefert das erste direkte Kind von <html>, das ein <body> oder ein veraltetes <frameset> ist, oder null, falls es kein solches Kind gibt. Beide Eigenschaften werden ohne Klammern gelesen.

Anders als bei documentElement kannst du body einen neuen Wert zuweisen und so das vorhandene Element ersetzen. Seine Kindknoten werden nicht in das neue Element verschoben. Wenn du null oder ein HTMLElement zuweist, das weder <body> noch <frameset> ist, wird HierarchyRequestError ausgelöst. Implementiert das Element HTMLElement nicht, etwa bei einem SVG-Element, löst die Web-IDL-Konvertierung einen TypeError aus, bevor der Setter aufgerufen wird. Ein gültiges <body>- oder <frameset>-Element löst ebenfalls HierarchyRequestError aus, wenn das Dokument kein Wurzelelement hat.

Während des Parsens existieren der Body oder das gesuchte Element möglicherweise noch nicht. Wenn dein Code vom Markup der Seite abhängt, warte bei document.readyState === "loading" auf DOMContentLoaded; andernfalls führe ihn sofort aus. Prüfe vor der Verwendung auf null: Ein direkter Eigenschaftszugriff auf null löst einen TypeError aus. Diese APIs sind in den DOM- und HTML-Standards definiert, nicht in ECMAScript. Die Versionsangabe ECMAScript 2024 sagt nichts über ihre Verfügbarkeit aus. Nicht jede JavaScript-Laufzeit stellt document bereit.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document lookup demo</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument("Demo");
    const panel = doc.createElement("section");
    panel.id = "Panel";

    console.log(doc.documentElement.localName);
    console.log(doc.body.localName);
    console.log(doc.getElementById("Panel"));

    doc.body.appendChild(panel);
    console.log(doc.getElementById("Panel") === panel);
    console.log(doc.getElementById("panel"));
  </script>
</body>
</html>

Ergebnis

html
body
null
true
null

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh in der Entwicklerkonsole nach. Das separate HTML-Dokument hat bereits `html` und `body` und verändert die Seite nicht, auf der das Skript läuft. `Panel` wird erst nach dem Einfügen gefunden; `panel` stimmt wegen der Groß- und Kleinschreibung nicht überein.

Zugehörige Lektionen

  • JavaScript · Lektion 37 · Fortgeschritten · Version: 4

Quellen