NavigationHistoryEntry

实例属性

从其父接口 EventTarget 继承属性。

id 只读 实验性

返回历史记录条目的 id。这是一个唯一的、由 UA 生成的值，始终代表特定的历史记录条目，可用于将其与外部资源（如存储缓存）关联。

index 只读 实验性

返回历史条目列表（即 Navigation.entries() 返回的列表）中历史条目的索引，如果该条目未出现在列表中，则返回 -1。

key 只读 实验性

返回历史条目的 key。这是一个唯一的 UA 生成值，表示历史条目在条目列表中的位置，而不是条目本身。它用于通过 Navigation.traverseTo() 导航该特定位置。替换列表中条目的其他条目将重用该 key（即，如果 NavigateEvent.navigationType 为 replace）。

sameDocument 只读 实验性

如果此历史记录条目与当前 Document 值属于同一个 document，则返回 true，否则返回 false。

url 只读 实验性

返回此历史记录条目的绝对 URL 地址。如果该条目对应的文档与当前文档不同（例如 sameDocument 属性为 false），并且该文档是在将 Referrer-Policy 标头设置为 no-referrer 或 origin 的情况下获取的，则该属性返回 null。

实例方法

从其父接口 EventTarget 继承方法。

getState() 实验性

返回与此历史记录条目相关的可用状态数据的克隆。

事件

dispose 实验性

当条目不再是历史条目列表的一部分时触发。

示例

function initHomeBtn() {
  // 获取第一个加载条目的键，以便用户可以随时返回该视图。
  const { key } = navigation.currentEntry;
  backToHomeButton.onclick = () => {
    navigation.traverseTo(key);
  };
}
// 拦截 navigate 事件（例如链接点击），并将其替换为单页导航
navigation.addEventListener("navigate", (event) => {
  event.intercept({
    async handler() {
      // 导航到不同的视图，但“主页”按钮始终有效
    },
  });
});

规范

浏览器兼容性

参见

• 现代客户端路由：导航 API
• 导航 API 说明
• Domenic Denicola 的导航 API 在线演示