Creates an XPathNSResolver
which resolves namespaces with respect to the definitions in scope for a specified node.
Syntax
nsResolver = document.createNSResolver(node);
Parameters
node
is the node to be used as a context for namespace resolution.
Return value
nsResolver
is an XPathNSResolver object.
Notes
Adapts any DOM node to resolve namespaces so that an XPath expression can be easily evaluated relative to the context of the node where it appeared within the document. This adapter works like the DOM Level 3 method lookupNamespaceURI
on nodes in resolving the namespaceURI
from a given prefix using the current information available in the node's hierarchy at the time lookupNamespaceURI
is called. Also correctly resolves the implicit xml
prefix.
Note, XPath defines QNames without prefix to match only elements in the null namespace. There is no way in XPath to pick up the default namespace as applied to a regular element reference (e.g., p[@id='_myid'
] for xmlns='http://www.w3.org/1999/xhtml'
). To match default elements in a non-null namespace, you either have to refer to a particular element using a form such as *namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid']
(this approach works well for dynamic XPath expressions where the namespaces might not be known) or use prefixed name tests, and create a namespace resolver mapping the prefix to the namespace. Read more on how to create a user defined namespace resolver if you wish to take the latter approach.
createNSResolver
was introduced in DOM Level 3.
See also
Specifications
Specification | Status | Comment |
---|---|---|
Document Object Model (DOM) Level 3 XPath Specification The definition of 'document.createNSResolver' in that specification. |
Recommendation |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
createNSResolver | Chrome Full support 1 | Edge Full support 12 | Firefox Full support Yes | IE ? | Opera ? | Safari ? | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android ? | Safari iOS ? | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown