Navigation：navigateerror 事件

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.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

Navigation 接口的 navigateerror 事件在导航失败后触发。

例如，如果网络中断，则调用任何 fetch() 方法处理导航都将失败，错误将被路由到 navigateerror。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理器属性。

addEventListener("navigateerror", (event) => {});

onnavigateerror = (event) => {};

你可以通过隐藏先前显示的进度指示器来处理成功的导航，如下所示：

navigation.addEventListener("navigatesuccess", (event) => {
  loadingIndicator.hidden = true;
});

或者你可能会在失败时显示一条错误消息：

navigation.addEventListener("navigateerror", (event) => {
  loadingIndicator.hidden = true; // 也隐藏指示器
  showMessage(`无法加载页面：${event.message}`);
});

Specification
HTML # event-navigateerror

This page was last modified on ⁨2025年3月9日⁩ by MDN contributors.