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.