NavigationHistoryEntry

例項屬性

繼承其父級 EventTarget 的屬性。

id 只讀 實驗性

返回歷史條目的 id。這是一個由使用者代理（UA）生成的唯一值，始終代表一個特定的歷史條目，可用於將其與外部資源（如快取）關聯。

index 只讀 實驗性

返回歷史條目在歷史條目列表（即 Navigation.entries() 返回的列表）中的索引，如果該條目未出現在列表中，則返回 -1。

key 只讀 實驗性

返回歷史條目的 key。這是一個由使用者代理（UA）生成的唯一值，代表歷史條目在條目列表中的槽位（slot），而不是條目本身。它用於透過 Navigation.traverseTo() 導航到該特定槽位。當其他條目替換該條目在列表中的位置時（即 NavigateEvent.navigationType 為 replace 時），key 會被重新使用。

sameDocument 只讀 實驗性

如果此歷史條目與當前 Document 物件屬於同一個 document，則返回 true，否則返回 false。

url 只讀 實驗性

返回此歷史條目的絕對 URL。如果該條目對應於與當前文件不同的文件（類似於 sameDocument 屬性為 false），並且該文件是使用 Referrer-Policy 頭部設定為 no-referrer 或 origin 來獲取的，則該屬性返回 null。

例項方法

繼承其父級 EventTarget 的方法。

getState() 實驗性

返回與此歷史條目關聯的可用狀態的克隆。

事件

dispose 實驗性

當條目不再是歷史條目列表的一部分時觸發。

示例

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

規範

瀏覽器相容性

另見

• 現代客戶端路由：導航 API
• 導航 API 直譯器
• Navigation API 即時演示 (檢視演示原始碼)