導航:navigateerror 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

Navigation 介面的 navigateerror 事件在導航失敗時觸發。

例如,如果網路中斷,用於處理導航的任何 fetch() 方法都會失敗,錯誤將路由到 navigateerror

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

onnavigateerror = (event) => { }

事件型別

一個 ErrorEvent。繼承自 Event

Event ErrorEvent

示例

您可以透過隱藏之前顯示的進度指示器來處理成功的導航,如下所示

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

瀏覽器相容性

另見