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.