NavigationHistoryEntry

Thuộc tính thể hiện

Kế thừa các thuộc tính từ giao diện cha, EventTarget.

id Read only

Trả về id của mục lịch sử. Đây là một giá trị duy nhất do UA tạo ra, luôn đại diện cho một mục lịch sử cụ thể, hữu ích để đối chiếu với tài nguyên bên ngoài như bộ nhớ đệm lưu trữ.

index Read only

Trả về chỉ số của mục lịch sử trong danh sách các mục lịch sử, hoặc -1 nếu mục đó không xuất hiện trong danh sách.

key Read only

Trả về key của mục lịch sử. Đây là một giá trị duy nhất do UA tạo ra, đại diện cho vị trí của mục trong danh sách thay vì chính mục đó. Nó được dùng để điều hướng đến vị trí cụ thể đó thông qua Navigation.traverseTo().

sameDocument Read only

Trả về true nếu mục lịch sử này thuộc cùng document với giá trị Document hiện tại, ngược lại trả về false.

url Read only

Trả về URL tuyệt đối của mục lịch sử này. Nếu mục đó tương ứng với một tài liệu khác với tài liệu hiện tại và tài liệu đó được tìm nạp với tiêu đề Referrer-Policy là no-referrer hoặc origin, thuộc tính sẽ trả về null.

Phương thức thể hiện

Kế thừa các phương thức từ giao diện cha, EventTarget.

getState()

Trả về một bản sao của trạng thái hiện có gắn với mục lịch sử này.

Sự kiện

dispose

Kích hoạt khi mục không còn là một phần của danh sách mục lịch sử.

Ví dụ

function initHomeBtn() {
  // Lấy key của mục đầu tiên được tải
  // để người dùng luôn có thể quay lại chế độ xem này.
  const { key } = navigation.currentEntry;
  backToHomeButton.onclick = () => {
    navigation.traverseTo(key);
  };
}
// Chặn các sự kiện navigate, chẳng hạn như nhấp vào liên kết, và
// thay thế chúng bằng các lần điều hướng đơn trang
navigation.addEventListener("navigate", (event) => {
  event.intercept({
    async handler() {
      // Điều hướng đến một chế độ xem khác,
      // nhưng nút "home" sẽ luôn hoạt động.
    },
  });
});

Thông số kỹ thuật

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

Xem thêm

• Modern client-side routing: the Navigation API
• Navigation API explainer
• Navigation API live demo (xem mã nguồn demo)