CKTIS / JavaScript
Element.querySelectorAll — iskanje potomcev
Element.querySelectorAll vrne statični NodeList potomcev, ki ustrezajo izbirniku CSS. Poznejše spremembe drevesa seznama ne posodobijo.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) vrne ustrezne potomce v vrstnem redu drevesa kot NodeList, ne kot polje. Klicni element sam ni vključen. Če ni ujemanj, je seznam prazen; querySelector namesto tega vrne prvi element ali null.
Seznam je statičen: spremembe drevesa ne posodobijo njegove vsebine, vendar vključeni elementi niso kopije. Nov klic vrne trenutne rezultate. Neveljaven izbirnik sproži DOMException z imenom SyntaxError.
Izbirnik lahko upošteva prednike zunaj klicnega elementa; za izbiro neposrednih otrok uporabi :scope > .item. To je API DOM, ne funkcija ECMAScripta; sama razpoložljivost Node.js še ne dokazuje podpore.
Primeri
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);Rezultat
1 2 true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.