CKTIS / JavaScript
document.getElementById — trovare un elemento tramite ID
document.getElementById(elementId) restituisce l’elemento con l’ID specificato oppure null. La ricerca distingue tra maiuscole e minuscole e comprende i discendenti del documento.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
document.getElementById(elementId)document.getElementById(elementId) è un metodo del DOM, non fa parte di ECMAScript in sé. Passa un valore id, per esempio "status", senza il prefisso #: l’argomento non è un selettore CSS. Il risultato è un Element oppure null. La ricerca distingue tra maiuscole e minuscole; un identificatore vuoto non corrisponde a nessun elemento.
Il metodo cerca tra i discendenti del documento. Un elemento scollegato non verrà trovato. In presenza di ID duplicati, restituisce il primo elemento nell’ordine dell’albero, che non è necessariamente il primo creato. Prima di usare il risultato, controlla che non sia null; esegui la ricerca solo dopo aver aggiunto l’elemento desiderato al documento.
getElementById è disponibile anche su DocumentFragment, ma non sui normali oggetti Element. La ricerca nel documento non entra negli alberi ombra. L’esempio richiede un ambiente DOM del browser; la sola presenza di una versione di Node.js non dimostra che questa API sia disponibile.
Esempi
{
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);
}Risultato
true true true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.