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.