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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.