Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri