CKTIS / JavaScript
Element.querySelectorAll — afstammelingselementen vinden
Element.querySelectorAll retourneert een statische NodeList van afstammelingen die overeenkomen met een CSS-selector. Latere wijzigingen aan de boom werken de lijst niet bij.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) retourneert overeenkomende afstammelingen in boomvolgorde als een NodeList, niet als een array. Het element waarop de methode wordt aangeroepen, is zelf niet inbegrepen. Zijn er geen overeenkomsten, dan is de lijst leeg; querySelector retourneert in plaats daarvan het eerste element of null.
De lijst is statisch: wijzigingen aan de boom werken de inhoud ervan niet bij, maar de opgenomen elementen zijn geen kopieën. Een nieuwe aanroep geeft actuele resultaten. Een ongeldige selector veroorzaakt een DOMException met de naam SyntaxError.
Een selector kan rekening houden met voorouders buiten het element waarop de methode wordt aangeroepen; gebruik :scope > .item om directe kinderen te selecteren. Dit is een DOM-API, geen ECMAScript-functie; alleen de beschikbaarheid van Node.js toont niet aan dat de API wordt ondersteund.
Voorbeelden
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);Resultaat
1 2 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.