Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.querySelectorAll — trovare gli elementi discendenti

Element.querySelectorAll restituisce un NodeList statico dei discendenti che corrispondono a un selettore CSS. Le modifiche successive all’albero non aggiornano la lista.

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

element.querySelectorAll(selectors)

Element.querySelectorAll(selectors) restituisce i discendenti corrispondenti nell’ordine dell’albero come NodeList, non come array. L’elemento su cui si chiama il metodo non è incluso. Se non ci sono corrispondenze, la lista è vuota; querySelector restituisce invece il primo elemento oppure null.

La lista è statica: le modifiche all’albero non ne aggiornano il contenuto, ma gli elementi inclusi non sono copie. Una nuova chiamata restituisce i risultati aggiornati. Un selettore non valido genera una DOMException denominata SyntaxError.

Un selettore può considerare antenati esterni all’elemento su cui si chiama il metodo; usa :scope > .item per selezionare i figli diretti. Questa è un’API DOM, non una funzionalità ECMAScript; la sola disponibilità di Node.js non dimostra che sia supportata.

Esempi

const root = document.createElement('section');
const first = document.createElement('span');
first.className = 'item';
root.append(first);

const matches = root.querySelectorAll('.item');
const second = document.createElement('span');
second.className = 'item';
root.append(second);

console.log(matches.length);
console.log(root.querySelectorAll('.item').length);
console.log(matches[0] === first);

Risultato

1
2
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