The definitions from the DOM Standard seems almost exactly the same, and I don't understand the difference.
What is the difference between queryAll
and querySelectorAll
.
The evaluation logic from DOM standard is below, but I am not smart enough to understand it.
query
& queryAll
To match a relative selectors string relativeSelectors against a set, run these steps:
Let s be the result of parse a relative selector from relativeSelectors against set. [SELECTORS]
If s is failure, throw a JavaScript TypeError.
Return the result of evaluate a selector s using :scope elements set. [SELECTORS]
The query(relativeSelectors) method must return the first result of running match a relative selectors string relativeSelectors against a set consisting of context object, and null if the result is an empty list.
The queryAll(relativeSelectors) method must return an Elements array initialized with the result of running match a relative selectors string relativeSelectors against a set consisting of context object.
querySelector
& querySelectorAll
To scope-match a selectors string selectors against a node, run these steps:
Let s be the result of parse a selector selectors. [SELECTORS]
If s is failure, throw a JavaScript TypeError.
Return the result of evaluate a selector s against node's root using scoping root node and scoping method scope-filtered. [SELECTORS].
The querySelector(selectors) method must return the first result of running scope-match a selectors string selectors against the context object, and null if the result is an empty list otherwise.
The querySelectorAll(selectors) method must return the static result of running scope-match a selectors string selectors against the context object.
queryAll
was removed from the DOM specCurrently the most important difference between queryAll
and querySelectorAll
is that queryAll
(as well as query
) was removed from the DOM specification.
The current version of the DOM specification is available at:
Note: https://www.w3.org/TR/dom/ is an outdated fork of the DOM Standard (see Fork tracking on the WHATWG Wiki and the comment by Domenic for more info).
The last version that included query
and queryAll
was published on 15 March 2016:
The next version doesn't mention query
or queryAll
anywhere:
All occurances of query
or queryAll
in the DOM standard were commented out by Anne van Kesteren on March 29, 2016.
The current DOM specification (as of July 2016) doesn't mention query
or queryAll
at all:
querySelector
and querySelectorAll
are in section
4.2.6 Mixin ParentNode.
It seems that currently the only reliable API is querySelector
and querySelectorAll
(see this answer for more details) and according to this discussion on GitHub query
and queryAll
will not be available until the JavaScript subclassing of built-ins is implemented in the browsers and even then it will be unlikely to return a live Elements[] array as described in the answer by BoltClock.
As of June 2016 there is no mention of query
and queryAll
on MDN:
On the other hand querySelector
and querySelectorAll
are well documented and widely supported:
Browser support of querySelector
/querySelectorAll
according to Can I use as of June 2016:
(See: http://caniuse.com/queryselector for up to date info)
There is no info available on the support of query
and queryAll
.
See also this answer for more info on the usage and browser support of querySelector
and querySelectorAll
.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With