CKTIS / JavaScript
document.querySelectorAll — todos los elementos coincidentes
Busca elementos mediante selectores CSS y devuelve una NodeList estática, incluso cuando no hay coincidencias.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
document.querySelectorAll(selectors)document.querySelectorAll(selectors) devuelve una NodeList estática con los elementos coincidentes, en el orden del árbol del documento. El argumento es una cadena de selector CSS, que también puede ser una lista separada por comas.
Si no hay coincidencias, devuelve una lista vacía, no null. Un selector no válido provoca una DOMException llamada SyntaxError. En cambio, document.querySelector(selectors) devuelve el primer elemento coincidente o null.
Una lista estática conserva sus elementos aunque haya cambios en el DOM; no los copia. Vuelve a realizar la consulta para obtener resultados actualizados. El ejemplo usa un documento independiente, por lo que no modifica la página abierta.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.