CKTIS / JavaScript
Element.querySelectorAll — buscar elementos descendientes
Element.querySelectorAll devuelve un NodeList estático de los descendientes que coinciden con un selector CSS. Los cambios posteriores en el árbol no actualizan la lista.
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
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) devuelve los descendientes coincidentes en el orden del árbol como un NodeList, no como un array. El elemento que realiza la llamada no se incluye. Si no hay coincidencias, devuelve una lista vacía; querySelector devuelve, en cambio, el primer elemento o null.
La lista es estática: los cambios en el árbol no actualizan su contenido, pero los elementos que contiene no son copias. Una nueva llamada devuelve los resultados actuales. Un selector no válido lanza una DOMException llamada SyntaxError.
Un selector puede tener en cuenta antepasados situados fuera del elemento que realiza la llamada; usa :scope > .item para seleccionar los hijos directos. Esta es una API del DOM, no una característica de ECMAScript; la disponibilidad de Node.js por sí sola no demuestra que sea compatible.
Ejemplos
const root = document.createElement('section');
const first = document.createElement('span');
first.className = 'item';
root.append(first);
const matches = root.querySelectorAll('.item');
const second = document.createElement('span');
second.className = 'item';
root.append(second);
console.log(matches.length);
console.log(root.querySelectorAll('.item').length);
console.log(matches[0] === first);Resultado
1 2 true
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.