导航:navigateerror 事件

可用性有限

此功能不是基线功能,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表格

navigateerrorNavigation 接口的事件,当导航失败时触发。

例如,如果网络断开,则用于处理导航的任何 fetch() 方法都将失败,并且错误将路由到 navigateerror

语法

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

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

onnavigateerror = (event) => {};

事件类型

示例

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

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

或者,您可以在失败时显示错误消息

js
navigation.addEventListener("navigateerror", (event) => {
  loadingIndicator.hidden = true; // also hide indicator
  showMessage(`Failed to load page: ${event.message}`);
});

规范

规范
HTML 标准
# event-navigateerror

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅