'use strict' const { ipcMainInternal } = require('@electron/internal/browser/ipc-main-internal') // The history operation in renderer is redirected to browser. ipcMainInternal.on('ELECTRON_NAVIGATION_CONTROLLER_GO_BACK', function (event) { event.sender.goBack() }) ipcMainInternal.on('ELECTRON_NAVIGATION_CONTROLLER_GO_FORWARD', function (event) { event.sender.goForward() }) ipcMainInternal.on('ELECTRON_NAVIGATION_CONTROLLER_GO_TO_OFFSET', function (event, offset) { event.sender.goToOffset(offset) }) ipcMainInternal.on('ELECTRON_NAVIGATION_CONTROLLER_LENGTH', function (event) { event.returnValue = event.sender.length() }) // JavaScript implementation of Chromium's NavigationController. // Instead of relying on Chromium for history control, we compeletely do history // control on user land, and only rely on WebContents.loadURL for navigation. // This helps us avoid Chromium's various optimizations so we can ensure renderer // process is restarted everytime. const NavigationController = (function () { function NavigationController (webContents) { this.webContents = webContents this.clearHistory() // webContents may have already navigated to a page. if (this.webContents._getURL()) { this.currentIndex++ this.history.push(this.webContents._getURL()) } this.webContents.on('navigation-entry-committed', (event, url, inPage, replaceEntry) => { if (this.inPageIndex > -1 && !inPage) { // Navigated to a new page, clear in-page mark. this.inPageIndex = -1 } else if (this.inPageIndex === -1 && inPage && !replaceEntry) { // Started in-page navigations. this.inPageIndex = this.currentIndex } if (this.pendingIndex >= 0) { // Go to index. this.currentIndex = this.pendingIndex this.pendingIndex = -1 this.history[this.currentIndex] = url } else if (replaceEntry) { // Non-user initialized navigation. this.history[this.currentIndex] = url } else { // Normal navigation. Clear history. this.history = this.history.slice(0, this.currentIndex + 1) this.currentIndex++ this.history.push(url) } }) } NavigationController.prototype.loadURL = function (url, options) { if (options == null) { options = {} } const p = new Promise((resolve, reject) => { const resolveAndCleanup = () => { removeListeners() resolve() } const rejectAndCleanup = (errorCode, errorDescription, url) => { const err = new Error(`${errorDescription} (${errorCode}) loading '${typeof url === 'string' ? url.substr(0, 2048) : url}'`) Object.assign(err, { errno: errorCode, code: errorDescription, url }) removeListeners() reject(err) } const finishListener = () => { resolveAndCleanup() } const failListener = (event, errorCode, errorDescription, validatedURL, isMainFrame, frameProcessId, frameRoutingId) => { if (isMainFrame) { rejectAndCleanup(errorCode, errorDescription, validatedURL) } } let navigationStarted = false const navigationListener = (event, url, isSameDocument, isMainFrame, frameProcessId, frameRoutingId, navigationId) => { if (isMainFrame) { if (navigationStarted && !isSameDocument) { // the webcontents has started another unrelated navigation in the // main frame (probably from the app calling `loadURL` again); reject // the promise // We should only consider the request aborted if the "navigation" is // actually navigating and not simply transitioning URL state in the // current context. E.g. pushState and `location.hash` changes are // considered navigation events but are triggered with isSameDocument. // We can ignore these to allow virtual routing on page load as long // as the routing does not leave the document return rejectAndCleanup(-3, 'ERR_ABORTED', url) } navigationStarted = true } } const stopLoadingListener = () => { // By the time we get here, either 'finish' or 'fail' should have fired // if the navigation occurred. However, in some situations (e.g. when // attempting to load a page with a bad scheme), loading will stop // without emitting finish or fail. In this case, we reject the promise // with a generic failure. // TODO(jeremy): enumerate all the cases in which this can happen. If // the only one is with a bad scheme, perhaps ERR_INVALID_ARGUMENT // would be more appropriate. rejectAndCleanup(-2, 'ERR_FAILED', url) } const removeListeners = () => { this.webContents.removeListener('did-finish-load', finishListener) this.webContents.removeListener('did-fail-load', failListener) this.webContents.removeListener('did-start-navigation', navigationListener) this.webContents.removeListener('did-stop-loading', stopLoadingListener) } this.webContents.on('did-finish-load', finishListener) this.webContents.on('did-fail-load', failListener) this.webContents.on('did-start-navigation', navigationListener) this.webContents.on('did-stop-loading', stopLoadingListener) }) // Add a no-op rejection handler to silence the unhandled rejection error. p.catch(() => {}) this.pendingIndex = -1 this.webContents._loadURL(url, options) this.webContents.emit('load-url', url, options) return p } NavigationController.prototype.getURL = function () { if (this.currentIndex === -1) { return '' } else { return this.history[this.currentIndex] } } NavigationController.prototype.stop = function () { this.pendingIndex = -1 return this.webContents._stop() } NavigationController.prototype.reload = function () { this.pendingIndex = this.currentIndex return this.webContents._loadURL(this.getURL(), {}) } NavigationController.prototype.reloadIgnoringCache = function () { this.pendingIndex = this.currentIndex return this.webContents._loadURL(this.getURL(), { extraHeaders: 'pragma: no-cache\n', reloadIgnoringCache: true }) } NavigationController.prototype.canGoBack = function () { return this.getActiveIndex() > 0 } NavigationController.prototype.canGoForward = function () { return this.getActiveIndex() < this.history.length - 1 } NavigationController.prototype.canGoToIndex = function (index) { return index >= 0 && index < this.history.length } NavigationController.prototype.canGoToOffset = function (offset) { return this.canGoToIndex(this.currentIndex + offset) } NavigationController.prototype.clearHistory = function () { this.history = [] this.currentIndex = -1 this.pendingIndex = -1 this.inPageIndex = -1 } NavigationController.prototype.goBack = function () { if (!this.canGoBack()) { return } this.pendingIndex = this.getActiveIndex() - 1 if (this.inPageIndex > -1 && this.pendingIndex >= this.inPageIndex) { return this.webContents._goBack() } else { return this.webContents._loadURL(this.history[this.pendingIndex], {}) } } NavigationController.prototype.goForward = function () { if (!this.canGoForward()) { return } this.pendingIndex = this.getActiveIndex() + 1 if (this.inPageIndex > -1 && this.pendingIndex >= this.inPageIndex) { return this.webContents._goForward() } else { return this.webContents._loadURL(this.history[this.pendingIndex], {}) } } NavigationController.prototype.goToIndex = function (index) { if (!this.canGoToIndex(index)) { return } this.pendingIndex = index return this.webContents._loadURL(this.history[this.pendingIndex], {}) } NavigationController.prototype.goToOffset = function (offset) { if (!this.canGoToOffset(offset)) { return } const pendingIndex = this.currentIndex + offset if (this.inPageIndex > -1 && pendingIndex >= this.inPageIndex) { this.pendingIndex = pendingIndex return this.webContents._goToOffset(offset) } else { return this.goToIndex(pendingIndex) } } NavigationController.prototype.getActiveIndex = function () { if (this.pendingIndex === -1) { return this.currentIndex } else { return this.pendingIndex } } NavigationController.prototype.length = function () { return this.history.length } return NavigationController })() module.exports = NavigationController