HOWTO · JavaScript
Controlla se l'elemento esiste in DOM in JavaScript
Questo tutorial spiega come verificare se l'elemento esiste in DOM in JavaScript
In questa pagina
Per verificare se esiste un elemento corrispondente, usa il metodo di ricerca adatto al criterio con cui lo identifichi. document.getElementById() restituisce l’elemento corrispondente oppure null, quindi controlla che il risultato sia truthy. Le ricerche per classe e tag restituiscono invece raccolte: controllane length, perché anche una raccolta vuota è truthy.
Usa getElementById() per trovare un elemento corrispondente
Usa getElementById() quando conosci l’id univoco di un elemento. Se l’ID corrisponde, il metodo restituisce un Element; se nessun elemento ha quell’ID, restituisce null. Passa l’ID senza il prefisso #.
L’esempio seguente, da eseguire in una pagina del browser, cerca il link con ID help-link. Nel blocco di codice, i nomi e il testo visibile restano in inglese:
<a id="help-link" href="/help">Help</a>
<script>
const helpLink = document.getElementById("help-link");
const exists = helpLink !== null;
console.log(exists);
</script>
La variabile exists è di tipo Boolean. Anche Boolean(helpLink) o !!helpLink converte il risultato in true o false. Usa !== null se vuoi rendere esplicito nel controllo il valore restituito dalla ricerca.
Controlla le corrispondenze per classe, nome e tag
Usa getElementsByClassName() per cercare una classe, getElementsByName() per cercare un attributo name e getElementsByTagName() per cercare il tag di un elemento. Questi metodi usano attributi diversi: per esempio, il valore di una classe va in class, mentre il nome di un controllo del modulo va in name.
Nel blocco di codice, i nomi e il testo visibile restano in inglese:
<input class="search-field" name="query">
<script>
const byClass = document.getElementsByClassName("search-field");
const byName = document.getElementsByName("query");
const byTag = document.getElementsByTagName("input");
console.log(byClass.length > 0);
console.log(byName.length > 0);
console.log(byTag.length > 0);
</script>
getElementsByClassName() e getElementsByTagName() restituiscono oggetti HTMLCollection aggiornati dinamicamente. getElementsByName() restituisce un NodeList. Se non ci sono corrispondenze, la raccolta ha lunghezza 0: resta comunque un oggetto, non diventa null. Per verificare se c’è una corrispondenza, usa collection.length > 0 (oppure collection.length !== 0).
Comprendi i risultati delle ricerche e i controlli Boolean
Una ricerca che restituisce un singolo elemento richiede un controllo diverso da una ricerca che restituisce una raccolta. Puoi convertire il risultato di getElementById() con Boolean(element) oppure confrontarlo con null. Per una raccolta ottenuta con una ricerca per classe, nome o tag, controlla invece length. Applicare direttamente !! a una raccolta non indica se contiene un elemento: sia una raccolta vuota sia una non vuota sono truthy.
Scegli l’API in base alla domanda: «Esiste un elemento con questo ID?» oppure «Quanti elementi corrispondono a questo criterio?». Se in seguito ti servono gli elementi, conserva l’elemento o la raccolta restituiti invece di convertirli subito in un valore Boolean.
Esegui questo esempio. Nel blocco di codice, i nomi e il testo visibile restano in inglese:
const matches = [{ id: "help-link" }];
const exists = matches.length > 0;
console.log(exists);
L’esempio illustra autonomamente il controllo della lunghezza della raccolta; gli snippet specifici del DOM riportati sopra sono codice sorgente per una pagina del browser e qui non vengono eseguiti.
Verifica se un nodo si trova dentro document.body
document.body.contains(node) restituisce un valore Boolean che indica se node è il body stesso o un suo discendente. Verifica il contenimento nell’albero DOM, non la visibilità del nodo sullo schermo. Un nodo può trovarsi nel body ed essere comunque nascosto con CSS o non visualizzato per altri motivi.
Passa un solo nodo a contains(). Se una ricerca restituisce una raccolta, scegli prima un elemento e considera che la raccolta potrebbe essere vuota. Per esempio, const matches = document.getElementsByName("query"); const isInBody = matches.length > 0 && document.body.contains(matches[0]); controlla soltanto il primo nodo corrispondente, non tutti. Se vuoi sapere se almeno uno dei nodi corrispondenti si trova nel body, controllali uno per uno.