NavigationHistoryEntry:key 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

NavigationHistoryEntry 介面的只讀屬性 key 返回歷史記錄條目的 key,如果當前文件未完全啟用,則返回一個空字串。這是一個由使用者代理(UA)生成的唯一值,代表了歷史記錄條目在條目列表中的“槽位”。它用於透過 Navigation.traverseTo() 導航到該特定槽位。當其他條目替換列表中的某個條目時(即,如果 NavigateEvent.navigationTypereplace),key 將被重複使用。

這與歷史記錄條目的 id 不同。id 是一個由使用者代理(UA)生成的唯一值,始終代表一個特定的歷史記錄條目,而不是它在條目列表中的槽位。這有助於將其與外部資源(如儲存快取)相關聯。

一個字串,代表 NavigationHistoryEntrykey

示例

基本用法

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

設定主頁按鈕

js
function initHomeBtn() {
  // Get the key of the first loaded entry
  // so the user can always go back to this view.
  const { key } = navigation.currentEntry;
  backToHomeButton.onclick = () => {
    navigation.traverseTo(key);
  };
}
// Intercept navigate events, such as link clicks, and
// replace them with single-page navigations
navigation.addEventListener("navigate", (event) => {
  event.intercept({
    async handler() {
      // Navigate to a different view,
      // but the "home" button will always work.
    },
  });
});

規範

規範
HTML
# dom-navigationhistoryentry-key-dev

瀏覽器相容性

另見