XPathResult
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Giao diện XPathResult đại diện cho các kết quả được tạo ra khi đánh giá một biểu thức XPath trong bối cảnh của một nút đã cho.
Vì các biểu thức XPath có thể tạo ra nhiều kiểu kết quả khác nhau, giao diện này giúp xác định và xử lý kiểu và giá trị của kết quả.
Thuộc tính phiên bản
XPathResult.booleanValueRead only-
Một giá trị
booleanđại diện cho giá trị của kết quả nếuresultTypelàBOOLEAN_TYPE. XPathResult.invalidIteratorStateRead only-
Cho biết iterator đã trở nên không hợp lệ. Là
truenếuresultTypelàUNORDERED_NODE_ITERATOR_TYPEhoặcORDERED_NODE_ITERATOR_TYPEvà tài liệu đã bị sửa đổi kể từ khi kết quả này được trả về. XPathResult.numberValueRead only-
Một
numberđại diện cho giá trị của kết quả nếuresultTypelàNUMBER_TYPE. XPathResult.resultTypeRead only-
Một mã
numberđại diện cho kiểu của kết quả, được định nghĩa bởi các hằng số kiểu. XPathResult.singleNodeValueRead only-
Một
Nodeđại diện cho giá trị của kết quả nút đơn, có thể lànull. XPathResult.snapshotLengthRead only-
Số lượng nút trong ảnh chụp kết quả.
XPathResult.stringValueRead only-
Một chuỗi đại diện cho giá trị của kết quả nếu
resultTypelàSTRING_TYPE.
Phương thức phiên bản
XPathResult.iterateNext()-
Nếu kết quả là một tập hợp nút, phương thức này lặp qua nó và trả về nút tiếp theo từ nó hoặc
nullnếu không còn nút nào. XPathResult.snapshotItem()-
Trả về một phần tử của tập hợp ảnh chụp hoặc
nulltrong trường hợp chỉ số nằm ngoài phạm vi của các nút. Không giống như kết quả iterator, ảnh chụp không trở nên không hợp lệ, nhưng có thể không tương ứng với tài liệu hiện tại nếu nó bị thay đổi.
Hằng số
| Hằng số kiểu kết quả được định nghĩa | Giá trị | Mô tả |
|---|---|---|
ANY_TYPE |
0 |
Một tập hợp kết quả chứa bất kỳ kiểu nào tự nhiên phát sinh từ việc đánh giá
biểu thức. Lưu ý rằng nếu kết quả là tập hợp nút thì
UNORDERED_NODE_ITERATOR_TYPE luôn là kiểu kết quả.
|
NUMBER_TYPE |
1 |
Một kết quả chứa một số đơn. Điều này hữu ích, ví dụ trong một
biểu thức XPath sử dụng hàm count().
|
STRING_TYPE |
2 |
Một kết quả chứa một chuỗi đơn. |
BOOLEAN_TYPE |
3 |
Một kết quả chứa một giá trị boolean đơn. Điều này hữu ích, ví dụ
trong một biểu thức XPath sử dụng hàm not().
|
UNORDERED_NODE_ITERATOR_TYPE |
4 |
Một tập hợp nút kết quả chứa tất cả các nút khớp với biểu thức. Các nút không nhất thiết phải theo cùng thứ tự mà chúng xuất hiện trong tài liệu. |
ORDERED_NODE_ITERATOR_TYPE |
5 |
Một tập hợp nút kết quả chứa tất cả các nút khớp với biểu thức. Các nút trong tập hợp kết quả theo cùng thứ tự mà chúng xuất hiện trong tài liệu. |
UNORDERED_NODE_SNAPSHOT_TYPE |
6 |
Một tập hợp nút kết quả chứa các ảnh chụp của tất cả các nút khớp với biểu thức. Các nút không nhất thiết phải theo cùng thứ tự mà chúng xuất hiện trong tài liệu. |
ORDERED_NODE_SNAPSHOT_TYPE |
7 |
Một tập hợp nút kết quả chứa các ảnh chụp của tất cả các nút khớp với biểu thức. Các nút trong tập hợp kết quả theo cùng thứ tự mà chúng xuất hiện trong tài liệu. |
ANY_UNORDERED_NODE_TYPE |
8 |
Một tập hợp nút kết quả chứa bất kỳ nút đơn nào khớp với biểu thức. Nút không nhất thiết là nút đầu tiên trong tài liệu khớp với biểu thức. |
FIRST_ORDERED_NODE_TYPE |
9 |
Một tập hợp nút kết quả chứa nút đầu tiên trong tài liệu khớp với biểu thức. |
Thông số kỹ thuật
| Specification |
|---|
| DOM> # interface-xpathresult> |