CKTIS / JavaScript
Element.querySelectorAll — vyhledávání potomků
Element.querySelectorAll vrací statický NodeList potomků, kteří odpovídají selektoru CSS. Pozdější změny stromu tento seznam neaktualizují.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) vrací odpovídající potomky v pořadí stromu jako NodeList, nikoli jako pole. Samotný volající element se do výsledku nezahrnuje. Pokud nejsou žádné shody, je seznam prázdný; querySelector místo toho vrací první element nebo null.
Seznam je statický: změny stromu neaktualizují jeho obsah, ale obsažené elementy nejsou kopie. Nové volání vrátí aktuální výsledky. Neplatný selektor vyvolá DOMException s názvem SyntaxError.
Selektor může zohlednit předky mimo volající element; pro výběr přímých potomků použijte :scope > .item. Jde o DOM API, nikoli o funkci ECMAScriptu; samotná dostupnost Node.js nedokládá podporu.
Příklady
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);Výsledek
1 2 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.