NavigationHistoryEntry: key property

Baseline 2026

Newly available

Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Thuộc tính chỉ đọc key của giao diện NavigationHistoryEntry trả về key của mục lịch sử, hoặc một chuỗi rỗng nếu tài liệu hiện tại không hoạt động đầy đủ. Đây là một giá trị duy nhất do UA tạo ra, đại diện cho vị trí của mục lịch sử trong danh sách. Nó được dùng để điều hướng đến vị trí cụ thể đó thông qua Navigation.traverseTo().

Điều này khác với id của một mục lịch sử. id 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ể thay vì vị trí của nó trong danh sách.

const current = navigation.currentEntry;
console.log(current.key);

Thiết lập nút home

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.
    },
  });
});