CKTIS / JavaScript
document.getElementById — vyhledání prvku podle ID
document.getElementById(elementId) vrací prvek se zadaným ID, nebo null. Vyhledávání rozlišuje velká a malá písmena a prohledává potomky dokumentu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.getElementById(elementId)document.getElementById(elementId) je metoda DOM, nikoli samotného ECMAScriptu. Předejte hodnotu id, například "status", bez předpony #: argument není CSS selektor. Výsledkem je Element nebo null. Vyhledávání rozlišuje velká a malá písmena; prázdný identifikátor ničemu neodpovídá.
Metoda prohledává potomky dokumentu. Odpojený prvek nenajde. Při duplicitních ID vrací první prvek v pořadí stromu, což nemusí být prvek vytvořený jako první. Před použitím výsledku ověřte, že není null; vyhledávání proveďte až poté, co cílový prvek přidáte do dokumentu.
getElementById je dostupné také na DocumentFragment, nikoli však na běžných objektech Element. Vyhledávání v dokumentu nevstupuje do stínových stromů. Příklad vyžaduje prostředí prohlížeče s DOM; samotná verze Node.js nedokládá dostupnost tohoto API.
Příklady
{
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);
}Výsledek
true true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.