Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti