Section 25.333. XPathResult.iterateNext( ): return the next node that matches an XPath query


25.333. XPathResult.iterateNext( ): return the next node that matches an XPath query

25.333.1. Synopsis

 Node iterateNext( )     throws DOMException 

25.333.1.1. Returns

Returns the next node in the list of matching nodes, or null if there are no more.

25.333.1.2. Throws

This method throws an exception if the document has been modified since the XPathResult was returned. It also throws an exception if called when returnType is not UNORDERED_NODE_ITERATOR_TYPE or ORDERED_NODE_ITERATOR_TYPE.

25.333.2. Description

iterateNext( ) returns the next node that matches the XPath query or null if all matching nodes have already been returned. Use this method if resultType is UNORDERED_NODE_ITERATOR_TYPE or ORDERED_NODE_ITERATOR_TYPE. If the type is ordered, nodes are returned in the order they appear in the document. Otherwise, they can be returned in any order.

If the invalidIteratorState property is true, the document has been modified, and this method throws an exception.




JavaScript. The Definitive Guide
JavaScript: The Definitive Guide
ISBN: 0596101996
EAN: 2147483647
Year: 2004
Pages: 767

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net