Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła