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.booleanValue Read only

Một giá trị boolean đại diện cho giá trị của kết quả nếu resultTypeBOOLEAN_TYPE.

XPathResult.invalidIteratorState Read only

Cho biết iterator đã trở nên không hợp lệ. Là true nếu resultTypeUNORDERED_NODE_ITERATOR_TYPE hoặc ORDERED_NODE_ITERATOR_TYPE và tài liệu đã bị sửa đổi kể từ khi kết quả này được trả về.

XPathResult.numberValue Read only

Một number đại diện cho giá trị của kết quả nếu resultTypeNUMBER_TYPE.

XPathResult.resultType Read 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.singleNodeValue Read only

Một Node đại diện cho giá trị của kết quả nút đơn, có thể là null.

XPathResult.snapshotLength Read only

Số lượng nút trong ảnh chụp kết quả.

XPathResult.stringValue Read only

Một chuỗi đại diện cho giá trị của kết quả nếu resultTypeSTRING_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 null nế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 null trong 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

Tương thích trình duyệt

Xem thêm