导航：back() 方法

可用性有限

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

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

back() 方法是 Navigation 接口的一种方法，它在导航历史记录中向后导航一个条目。

语法

js
back(options)

参数

options 可选

包含以下属性的选项对象

info 可选

开发者定义的信息，将传递给 navigate 事件，并在 NavigateEvent.info 中提供。这可以是任何数据类型。例如，你可能希望根据导航方式（向左滑动、向右滑动或返回首页）以不同的动画显示新导航的内容。可以将指示使用哪个动画的字符串作为 info 传递。

返回值

包含以下属性的对象

committed

一个 Promise，当可见 URL 发生更改并创建了一个新的 NavigationHistoryEntry 时，该 Promise 将 fulfilled。

finished

一个 Promise，当 intercept() 处理程序返回的所有 Promise 都 fulfilled 时，该 Promise 将 fulfilled。这相当于 NavigationTransition.finished Promise fulfilled 时，当 navigatesuccess 事件触发时。

如果导航由于某种原因失败，则其中任何一个 Promise 都将 rejected。

异常

InvalidStateError DOMException

如果 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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参见