WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

document.getElementById — ein Element anhand seiner ID finden

document.getElementById(elementId) gibt das Element mit der angegebenen ID oder null zurück. Die Suche unterscheidet Groß- und Kleinschreibung und umfasst die Nachfahren des Dokuments.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

document.getElementById(elementId)

document.getElementById(elementId) ist eine DOM-Methode und gehört nicht zum ECMAScript selbst. Übergib einen id-Wert wie "status" ohne vorangestelltes #: Das Argument ist kein CSS-Selektor. Das Ergebnis ist ein Element oder null. Bei der Suche wird die Groß- und Kleinschreibung beachtet; eine leere Kennung führt zu keinem Treffer.

Die Methode durchsucht die Nachfahren des Dokuments. Ein abgetrenntes Element wird nicht gefunden. Bei doppelten IDs gibt sie das erste Element in Baumreihenfolge zurück, nicht unbedingt das zuerst erstellte. Prüfe vor der Verwendung des Ergebnisses, ob es null ist; führe die Suche erst aus, nachdem das Zielelement zum Dokument hinzugefügt wurde.

getElementById ist auch auf DocumentFragment verfügbar, nicht aber auf gewöhnlichen Element-Objekten. Die Suche im Dokument dringt nicht in Shadow Trees ein. Das Beispiel benötigt eine Browser-DOM-Umgebung; eine Node.js-Version allein belegt nicht, dass diese API verfügbar ist.

Beispiele

{
  const document = globalThis.document.implementation.createHTMLDocument("");
  const item = document.createElement("div");
  item.id = "status";

  console.log(document.getElementById("status") === null);
  document.body.appendChild(item);
  console.log(document.getElementById("status") === item);
  console.log(document.getElementById("Status") === null);
  item.remove();
  console.log(document.getElementById("status") === null);
}

Ergebnis

true
true
true
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen