CKTIS / JavaScript
Element.querySelectorAll — намиране на низходящи елементи
Element.querySelectorAll връща статичен NodeList с низходящите елементи, които съответстват на CSS селектор. Последващите промени в дървото не актуализират списъка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) връща съответстващите низходящи елементи в реда на дървото като NodeList, а не като масив. Самият елемент, върху който се извиква методът, не се включва. Ако няма съвпадения, списъкът е празен; querySelector вместо това връща първия елемент или null.
Списъкът е статичен: промените в дървото не актуализират съдържанието му, но включените елементи не са копия. Ново извикване връща актуалните резултати. Невалиден селектор предизвиква DOMException с име SyntaxError.
Селекторът може да отчита предци извън елемента, върху който се извиква методът; използвайте :scope > .item, за да изберете преките деца. Това е DOM API, а не функция на ECMAScript; само наличието на Node.js не доказва поддръжка.
Примери
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);Резултат
1 2 true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.