Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

document.getElementById — wyszukiwanie elementu według ID

document.getElementById(elementId) zwraca element o podanym ID albo null. Wyszukiwanie rozróżnia wielkość liter i obejmuje potomków dokumentu.

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

Składnia

document.getElementById(elementId)

document.getElementById(elementId) to metoda DOM, nie samego ECMAScript. Przekaż wartość id, np. "status", bez prefiksu #: argument nie jest selektorem CSS. Wynikiem jest Element albo null. Wielkość liter ma znaczenie; pusty identyfikator nie daje dopasowania.

Metoda przeszukuje potomków dokumentu. Odłączony element nie zostanie znaleziony. Przy powtórzonych ID zwracany jest pierwszy element w kolejności drzewa, niekoniecznie pierwszy utworzony. Przed użyciem wyniku sprawdź, czy nie jest null; wykonaj wyszukiwanie dopiero po dodaniu szukanego elementu do dokumentu.

getElementById jest dostępne także na DocumentFragment, ale nie na zwykłych obiektach Element. Wyszukiwanie w dokumencie nie wchodzi do drzew cienia. Przykład wymaga środowiska DOM w przeglądarce; sama wersja Node.js nie potwierdza dostępności tego API.

Przykłady

{
  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);
}

Wynik

true
true
true
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła