Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti