CKTIS / JavaScript
Element.querySelector — primo discendente corrispondente
Element.querySelector cerca il primo discendente che corrisponde a un selettore CSS. Restituisce un elemento oppure null; un selettore non valido genera un’eccezione.
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.querySelector(selectors)Element.querySelector accetta una stringa selectors che contiene un selettore CSS o un elenco di selettori separati da virgole. Restituisce il primo discendente corrispondente nell’ordine dell’albero, non nell’ordine dell’elenco dei selettori. L’elemento su cui viene chiamato non è esso stesso un risultato.
Se non ci sono corrispondenze, restituisce null. Controlla il risultato prima di accedere alle proprietà. Una sintassi del selettore non valida genera una DOMException denominata SyntaxError, invece di restituire null.
Usa :scope > .action per selezionare un figlio diretto. Senza :scope, la corrispondenza del selettore può considerare antenati esterni all’elemento chiamante, anche se il risultato rimane un suo discendente. querySelectorAll() restituisce un elenco statico di tutte le corrispondenze, invece di un singolo elemento.
Questa è un’API dello standard DOM, non una funzionalità del linguaggio ECMAScript. L’esempio richiede un ambiente browser con DOM; la presenza di Node 24 in un repository non dimostra il supporto di questa API.
Esempi
const root = document.createElement('section');
const first = document.createElement('button');
const second = document.createElement('button');
first.className = 'action';
second.className = 'action';
first.textContent = 'First';
second.textContent = 'Second';
root.append(first, second);
console.log(root.querySelector('.action').textContent);
console.log(root.querySelector(':scope > .action') === first);
console.log(root.querySelector('.missing') === null);Risultato
First 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.