CKTIS / JavaScript
document.getElementById — iskanje elementa po ID-ju
document.getElementById(elementId) vrne element z navedenim ID-jem ali null. Iskanje razlikuje med velikimi in malimi črkami ter preišče potomce dokumenta.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.getElementById(elementId)document.getElementById(elementId) je metoda DOM-a, ne samega ECMAScripta. Podaj vrednost id, na primer "status", brez predpone #: argument ni izbirnik CSS. Rezultat je Element ali null. Iskanje razlikuje med velikimi in malimi črkami; prazen identifikator se ne ujema z ničemer.
Metoda išče med potomci dokumenta. Odklopljenega elementa ne bo našla. Če je ID podvojen, vrne prvi element po vrstnem redu v drevesu, ki ni nujno prvi ustvarjeni element. Pred uporabo rezultata preveri, ali je null; iskanje izvedi šele, ko ciljni element dodaš v dokument.
getElementById je na voljo tudi na DocumentFragment, ne pa na običajnih objektih Element. Iskanje v dokumentu ne vstopi v senčna drevesa. Primer zahteva brskalniško okolje DOM; sama različica Node.js še ne potrjuje, da je ta API na voljo.
Primeri
{
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);
}Rezultat
true true true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.