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 实时演示 (查看演示源码)