A NodeFilter
interface represents an object used to filter the nodes in a NodeIterator
or TreeWalker
. A NodeFilter
knows nothing about the document or traversing nodes; it only knows how to evaluate a single node against the provided filter.
Note: The browser doesn't provide any object implementing this interface. It is the user who is expected to write one, tailoring the acceptNode()
method to its needs, and using it with some TreeWalker
or NodeIterator
objects.
Properties
This interface neither implements nor inherits any properties.
Methods
This interface doesn't inherit any methods.
NodeFilter.acceptNode()
Returns an
unsigned short
that will be used to tell if a givenNode
must be accepted or not by theNodeIterator
orTreeWalker
iteration algorithm.This method is expected to be written by the user of a
NodeFilter
. Possible return values are:Constant Description FILTER_ACCEPT
Value returned by the NodeFilter.acceptNode()
method when a node should be accepted.FILTER_REJECT
Value to be returned by the
NodeFilter.acceptNode()
method when a node should be rejected. ForTreeWalker
, child nodes are also rejected.For
NodeIterator
, this flag is synonymous withFILTER_SKIP
.FILTER_SKIP
Value to be returned by
NodeFilter.acceptNode()
for nodes to be skipped by theNodeIterator
orTreeWalker
object.The children of skipped nodes are still considered. This is treated as "skip this node but not its children".
Example
const nodeIterator = document.createNodeIterator(
// Node to use as root
document.getElementById('someId'),
// Only consider nodes that are text nodes (nodeType 3)
NodeFilter.SHOW_TEXT,
// Object containing the function to use for the acceptNode method
// of the NodeFilter
{
acceptNode: function(node) {
// Logic to determine whether to accept, reject or skip node
// In this case, only accept nodes that have content
// other than whitespace
if (/\S/.test(node.data)) {
return NodeFilter.FILTER_ACCEPT
}
}
},
false
);
// Show the content of every non-empty text node that is a child of root
let node;
while ((node = nodeIterator.nextNode())) {
alert(node.data)
}
Specifications
Specification | Status | Comment |
---|---|---|
DOMThe definition of 'NodeFilter' in that specification. | Living Standard | |
Document Object Model (DOM) Level 2 Traversal and Range SpecificationThe definition of 'NodeFilter' in that specification. | Obsolete | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
NodeFilter
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support 2 |
IE
Full support 9 |
Opera
Full support 9 |
Safari
Full support 3 |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 4 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 3 |
Samsung Internet Android
Full support Yes |
acceptNode
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
Full support 2 |
IE
Full support 9 |
Opera
Full support 9 |
Safari
Full support 3 |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 4 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 3 |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
See also
- Related interfaces
NodeFilter by Mozilla Contributors is licensed under CC-BY-SA 2.5.