WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Document.getElementById() und documentElement: ID-Suche und Wurzelelement

`getElementById()` sucht ein Element anhand seiner exakten ID, `documentElement` liefert das Wurzelelement des Dokuments. Beide können aus unterschiedlichen Gründen `null` liefern.

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

Syntax

doc.getElementById(id) // Element or null
doc.documentElement    // Element or null; read-only

doc.getElementById(id) durchsucht den aktuellen Baum von doc. Übergib die ID selbst, etwa 'Panel', ohne das Präfix # eines CSS-Selektors voranzustellen. Die Methode beachtet die Groß- und Kleinschreibung und liefert ein Element oder null, wenn nichts passt. HTML-IDs müssen innerhalb ihres Baums eindeutig sein. Bei Duplikaten liefert die Methode den ersten Treffer in Baumreihenfolge.

Die Suche erfasst weder Elemente, die nicht in diesen Baum eingefügt wurden, noch Elemente in Shadow-Bäumen. Läuft dein Skript vor dem Einfügen, kann das Ergebnis null sein. Prüfe es, bevor du auf eine Eigenschaft zugreifst. Ein späterer Aufruf sucht erneut, aber eine gespeicherte Elementreferenz ändert sich beim Entfernen des Elements nicht.

doc.documentElement ist eine schreibgeschützte Eigenschaft, keine Methode. Sie liefert das Wurzelelement unabhängig von seiner ID: in einem typischen HTML-Dokument html, in XML das jeweilige Wurzelelement. Gemeint ist weder der Document-Knoten selbst noch body. Ohne Wurzelelement ist der Wert null.

Beide gehören zur DOM-API der Webplattform, nicht zu ECMAScript 2024. JavaScript-Unterstützung allein garantiert nicht, dass document verfügbar ist.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document ID lookup and root element</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument('Demo');
      const panel = doc.createElement('div');
      panel.id = 'Panel';

      console.log(doc.documentElement.localName);
      console.log(doc.getElementById('Panel'));
      doc.body.appendChild(panel);
      console.log(doc.getElementById('Panel') === panel);
      console.log(doc.getElementById('panel'));
      console.log(new Document().documentElement);
    })();
  </script>
</body>
</html>

Ergebnis

html
null
true
null
null

Speichere das Beispiel als `.html`-Datei, öffne sie in einem Browser und prüfe die Ausgabe in der Entwicklerkonsole. Das Beispiel erzeugt ein separates HTML-Dokument und verändert die aktuelle Seite nicht. `'Panel'` wird erst nach dem Einfügen gefunden, `'panel'` passt nicht, und ein neues leeres `Document` hat kein Wurzelelement.

Zugehörige Lektionen

  • JavaScript · Lektion 19 · Fortgeschritten · Version: 4
  • JavaScript · Lektion 33 · Fortgeschritten · Version: 4

Quellen