snapshotItem method (XPathResult)
Returns a matching node from the snapshots collection.
The XPathResult object represents the result of the evaluate method. The type of the result depends on the fourth parameter of the evaluate method, or if its value is ANY_TYPE, then it depends on the expression specified by the first parameter.
With the resultType property, the type of the result can be retrieved. If the value of the resultType property is UNORDERED_NODE_SNAPSHOT_TYPE or ORDERED_NODE_SNAPSHOT_TYPE, then the result contains snapshots for all nodes that match the expression. In this case, the snapshotItem method can be used to retrieve the matching nodes from the snapshots collection, by position. Use the snapshotLength property to get the length of the snapshots collection.The snapshotItem method is similar to the iterateNext method. Both provide access to the matching nodes. The main difference is that the modification of the document invalidates the iteration, but does not invalidate the snapshots collection.
You can find the related objects in the Supported by objects section below.
|Required. A zero-based integer that specifies the position of the matching node.|
Returns the node at the specified position. If the value of the index parameter is negative or greater than or equal to the number of nodes in the snapshots collection, it returns null.
Example HTML code 1:
This example shows how to get all span elements that are immediate children of a given element:
Did you find this example helpful?
User Contributed Comments