CKTIS / JavaScript
Element.querySelectorAll — wyszukiwanie elementów potomnych
Element.querySelectorAll zwraca statyczny NodeList potomków pasujących do selektora CSS. Późniejsze zmiany drzewa nie aktualizują listy.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.querySelectorAll(selectors)Element.querySelectorAll(selectors) zwraca pasujących potomków w kolejności drzewa jako NodeList, nie tablicę. Sam element wywołujący nie jest wynikiem. Brak dopasowań oznacza pustą listę; querySelector zwraca zamiast niej pierwszy element albo null.
Lista jest statyczna: zmiany drzewa nie aktualizują jej składu, ale zawarte w niej elementy nie są kopiami. Nowe wywołanie daje aktualny wynik. Niepoprawny selektor powoduje DOMException o nazwie SyntaxError.
Selektor może uwzględniać przodków poza elementem wywołującym; użyj :scope > .item, aby wskazać bezpośrednie dzieci. To API DOM, nie funkcja ECMAScript; sama dostępność Node.js nie dowodzi obsługi.
Przykłady
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);Wynik
1 2 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.