База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

document.getElementById — намиране на елемент по ID

document.getElementById(elementId) връща елемента със зададения ID или null. Търсенето различава главни и малки букви и обхожда потомците на документа.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

document.getElementById(elementId)

document.getElementById(elementId) е метод на DOM, а не част от самия ECMAScript. Подайте стойност id, например "status", без префикс #: аргументът не е CSS селектор. Резултатът е Element или null. Търсенето различава главни и малки букви; празен идентификатор не съвпада с нищо.

Методът търси сред потомците на документа. Откачен елемент няма да бъде намерен. При повтарящи се ID връща първия елемент според реда в дървото, който не е непременно първият създаден. Преди да използвате резултата, проверете дали не е null; извършете търсенето едва след като добавите целевия елемент към документа.

getElementById е наличен и върху DocumentFragment, но не и върху обикновени обекти Element. Търсенето в документа не влиза в сенчестите дървета. Примерът изисква браузърна DOM среда; наличието само на версия на Node.js не доказва, че този API се поддържа.

Примери

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

Резултат

true
true
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници