What's the difference between queryAll and querySelectorAll
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.
Answer
2016 Update
queryAll was removed from the DOM spec
Currently 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).
Last mention
The last version that included query and queryAll was published on 15 March 2016:
- http://web.archive.org/web/20160315085447/https://dom.spec.whatwg.org/
- See sections 4.2.3. Interface ParentNode and 4.2.6. Collections: Elements
Removal
The next version doesn't mention query or queryAll anywhere:
- http://web.archive.org/web/20160329233515/https://dom.spec.whatwg.org/
- See section 4.2.6. Mixin ParentNode
Current specification
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.
Browser support
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:
- https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll
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.
More info
See also this answer for more info on the usage and browser support of querySelector and querySelectorAll.