NavigationHistoryEntry：dispose 事件
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.
NavigationHistoryEntry 接口的 dispose 事件在条目不再是历史记录条目列表的一部分时触发。
处置发生在以下情况：
- 清除前进历史条目。有关更多信息，请参阅条目处置通知中的示例。
- 用户使用设置或提供的 UI 控件清除其浏览器历史记录。
- 超出历史记录限制。这在任何地方都没有指定，但浏览器的历史记录限制往往为 50 页。
语法
在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理器属性。
js
addEventListener("dispose", (event) => {});
ondispose = (event) => {};
事件类型
通用的 Event。
示例
js
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", disposeHandler);
});
规范
| Specification |
|---|
| HTML # handler-navigationhistoryentry-ondispose |
浏览器兼容性
参见
- 现代客户端路由：导航 API
- 导航 API 说明
- Domenic Denicola 的导航 API 在线演示