HTMLIFrameElement.getCanGoForward()

The getCanGoForward() method of the HTMLIFrameElement is used to indicate whether it's possible to go forward in the navigation history of the browser <iframe>.

Syntax

There is a DOMRequest version and a Promise version:

var instanceOfDOMRequest = instanceOfHTMLIframeElement.getCanGoForward();

instanceOfHTMLIframeElement.getCanGoForward()
.then(function(result) { ... });

Returns

Returns either

• A DOMRequest object to handle the request's success or error. If the request is successful, the request's result will be a boolean indicating if the history can be navigated forward (true) or not (false).
• A Promise that resolves with a boolean that equals true if the history can be navigated forward or false if not.

Parameters

None.

Example

DOMRequest:

function canMoveFwd() {
  var request = browser.getCanGoForward();
  request.onsuccess = function() {
    if (request.result) {
      fwd.disabled = false;
      console.log("It's possible to navigate
                   the history forward.");
    } else {
      fwd.disabled = true;
      console.log("It's not possible to navigate
                   the history forward.");
    }
  }
}

Promise:

function canMoveFwd() {
  browser.getCanGoForward().then(function(result) {
    if (result) {
      fwd.disabled = false;
      console.log("It's possible to navigate
                   the history forward.");
    } else {
      fwd.disabled = true;
      console.log("It's not possible to navigate
                   the history forward.");
    }
  });
}

Specification

Not part of any specification.

Browser compatibility

[1] Supported in chrome code only.

See also

• Using the Browser API