Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

document.querySelectorAll — todos os elementos correspondentes

Procura elementos com seletores CSS e devolve uma NodeList estática, mesmo quando não há correspondências.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

document.querySelectorAll(selectors)

document.querySelectorAll(selectors) devolve uma NodeList estática dos elementos correspondentes, pela ordem da árvore do documento. O argumento é uma cadeia de seletor CSS, que também pode ser uma lista separada por vírgulas.

Quando não há correspondências, devolve uma lista vazia, não null. Um seletor inválido lança uma DOMException com o nome SyntaxError. Em contrapartida, document.querySelector(selectors) devolve o primeiro elemento correspondente ou null.

Uma lista estática mantém os mesmos elementos após alterações no DOM; não copia os elementos. Volte a executar a consulta para obter resultados atualizados. O exemplo usa um documento separado e, por isso, não altera a página aberta.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.querySelectorAll</title>
</head>
<body>
  <h1>All matching elements</h1>
  <ul id="items">
    <li class="item">First item</li>
  </ul>
  <script>
    const matches = document.querySelectorAll('.item');
    const added = document.createElement('li');
    added.className = 'item';
    added.textContent = 'Second item';
    document.getElementById('items').append(added);

    console.log(matches.length);
    console.log(document.querySelectorAll('.item').length);
    console.log(document.querySelectorAll('.missing').length);
  </script>
</body>
</html>

Resultado

1
2
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes