Ce face document.getElementById
getElementById returnează elementul al cărui atribut id este exact textul dat, fără # în față. Dacă nu există, returnează null.
Este echivalent cu document.querySelector("#id"), dar mai rapid și fără probleme cu id-urile care încep cu cifră sau conțin caractere speciale. Metoda există doar pe document, nu pe elemente.
Parametri
| Parametru | Descriere |
|---|---|
id |
Valoarea atributului id, fără #. |
Ce returnează
Elementul găsit sau null.
Exemple
Exemplul 1: Citirea și modificarea unui element
<p id="mesaj">Se încarcă...</p>
<script>
const mesaj = document.getElementById("mesaj");
console.log(mesaj.textContent);
mesaj.textContent = "Gata!";
console.log(document.getElementById("inexistent"));
</script>
Rezultat în browser
Se încarcă...
null
Exemplul 2: Id care începe cu cifră
<section id="2026-program">...</section>
<script>
console.log(document.getElementById("2026-program").tagName);
try {
document.querySelector("#2026-program");
} catch (e) {
console.log(e.name);
}
</script>
Rezultat în browser
SECTION
SyntaxError
Greșeli frecvente
- Scrii
getElementById("#mesaj"), cu diez. Metoda primește doar id-ul și returneazănull. - Folosești același id pe mai multe elemente. Id-urile trebuie să fie unice; metoda returnează doar primul element.
Comenzi înrudite
document.querySelector: Găsește primul element din pagină care se potrivește cu un selector CSS.getElementsByClassName / getElementsByTagName: Găsesc elementele după clasă, etichetă sau atributul name; rezultatul este o listă „vie”.textContent / innerHTML: Citește sau schimbă conținutul unui element: ca text simplu sau ca HTML.