Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.querySelectorAll — vyhľadávanie potomkov

Element.querySelectorAll vracia statický NodeList potomkov, ktorí zodpovedajú selektoru CSS. Neskoršie zmeny stromu tento zoznam neaktualizujú.

Verzia: 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) vracia zodpovedajúcich potomkov v poradí stromu ako NodeList, nie ako pole. Samotný volajúci element nie je súčasťou výsledku. Ak sa nenájdu žiadne zhody, zoznam je prázdny; querySelector namiesto toho vráti prvý element alebo null.

Zoznam je statický: zmeny stromu neaktualizujú jeho obsah, ale obsiahnuté elementy nie sú kópie. Nové volanie vráti aktuálne výsledky. Neplatný selektor vyvolá DOMException s názvom SyntaxError.

Selektor môže zohľadniť predkov mimo volajúceho elementu; na výber priamych potomkov použite :scope > .item. Ide o DOM API, nie o funkciu ECMAScriptu; samotná dostupnosť Node.js nedokazuje podporu.

Prí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ýsledok

1
2
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje