CKTIS / JavaScript
document.querySelector — il primo elemento corrispondente
document.querySelector(selectors) cerca il primo elemento che corrisponde a un selettore CSS. Restituisce un elemento o 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
document.querySelector(selectors)document.querySelector(selectors) è un metodo del DOM, non fa parte di ECMAScript in sé. Accetta una stringa con un selettore CSS e restituisce il primo Element corrispondente nell’ordine dell’albero del documento, oppure null.
Controlla che il risultato non sia null prima di leggerne le proprietà. La sintassi non valida del selettore genera una DOMException chiamata SyntaxError, invece di restituire null. Con un elenco di selettori separati da virgole, il risultato dipende dall’ordine degli elementi nell’albero, non dall’ordine dei selettori.
Al contrario, querySelectorAll() restituisce un elenco statico di tutte le corrispondenze. L’esempio chiama querySelector() sul document della pagina corrente, quindi le corrispondenze dipendono dal codice HTML di quella pagina.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.querySelector</title>
</head>
<body>
<h1>First matching element</h1>
<ul>
<li class="item">First</li>
<li class="item">Second</li>
</ul>
<script>
console.log(document.querySelector('.item').textContent);
console.log(document.querySelector('.missing') === null);
try {
document.querySelector('[');
} catch (error) {
console.log(error.name);
}
</script>
</body>
</html>Risultato
First true SyntaxError
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.