Skip to content

NavigationHistory ​

NavigationHistory 表示一张网页的后退和前进:能不能后退、前进,以及后退、前进一页。

它从 webContents.navigationHistory 得到,一张网页只有一个。

继承关系:NavigationHistory(不继承 EventTarget,没有事件)

构造函数 ​

不能用 new 创建:抛 TypeError: Illegal constructor: NavigationHistory is created by the runtime, not by new。从 webContents.navigationHistory 得到。

实例方法 ​

方法说明
canGoBack()能不能后退
canGoForward()能不能前进
goBack()后退一页
goForward()前进一页

能不能后退、前进在每次 did-navigate 之后可能变化,在那个事件里重新读。

网页被销毁之后,四个方法都抛 TypeError: Object has been destroyed。

示例 ​

js
const contents = new WebView().webContents;
const history = contents.navigationHistory;
contents.addEventListener('did-navigate', () => {
  console.log('能后退', history.canGoBack(), '能前进', history.canGoForward());
});
await contents.loadURL('https://example.com/');
await contents.loadURL('https://example.com/about');
history.goBack();

结果:依次输出 能后退 false 能前进 false、能后退 true 能前进 false、能后退 false 能前进 true。

与 Electron 的对照 ​

Electron这里差别
contents.navigationHistory.canGoBack() / canGoForward()相同
contents.navigationHistory.goBack() / goForward()相同

对应的 iOS API ​

ObjC(WKWebView)JS
webView.canGoBack / canGoForwardcanGoBack() / canGoForward()
[webView goBack] / [webView goForward]goBack() / goForward()

参见 ​