導航:back() 方法
Navigation 介面的 back() 方法會在導航歷史中向後移動一個條目。
語法
js
back(options)
引數
options可選-
一個包含以下屬性的選項物件
info可選-
要傳遞給
navigate事件的開發者定義的資訊,可在NavigateEvent.info中訪問。這可以是任何資料型別。例如,您可能希望根據內容的導航方式(左滑、右滑或主頁)以不同的動畫顯示新導航的內容。可以將指示使用哪種動畫的字串作為info傳遞。
返回值
具有以下屬性的物件:
committed-
一個
Promise,當可見 URL 已更改且已建立新的NavigationHistoryEntry時,它將fulfilled。 finished-
一個
Promise,當intercept()處理程式返回的所有 Promise 都 fulfilled 時,它將 fulfilled。這相當於NavigationTransition.finishedPromise fulfilled,當navigatesuccess事件觸發時。
如果導航因某種原因失敗,則這兩個 Promise 中的任何一個都會 rejected。
異常
InvalidStateErrorDOMException-
如果
Navigation.currentEntry的NavigationHistoryEntry.index值為 -1 或 0,則會丟擲此錯誤。這意味著當前Document尚未啟用,或者當前歷史記錄條目是歷史記錄中的第一個條目,這意味著無法向後導航,或者當前Document正在解除安裝。
示例
js
async function backHandler() {
if (navigation.canGoBack) {
await navigation.back().finished;
// Handle any required clean-up after
// navigation has finished
} else {
displayBanner("You are on the first page");
}
}
async function forwardHandler() {
if (navigation.canGoForward) {
await navigation.forward().finished;
// Handle any required clean-up after
// navigation has finished
} else {
displayBanner("You are on the last page");
}
}
規範
| 規範 |
|---|
| HTML # dom-navigation-back-dev |
瀏覽器相容性
載入中…