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.