sessions.getRecentlyClosed()

Returns an array of Session objects, representing windows and tabs that were closed in the current browsing session (that is: the time since the browser was started).

This is an asynchronous function that returns a Promise.

Syntax

var gettingSessions = browser.sessions.getRecentlyClosed(
  filter             // optional object
)

Parameters

filterOptional
object. A sessions.Filter object that limits the set of sessions returned.

Return value

A Promise. This will be fulfilled with an array of Session objects, one for each of the most recently closed tabs or windows in the current browsing session, up to sessions.MAX_SESSION_RESULTS or the number included in the filter argument, whichever is smaller. The array is given in the reverse of the order in which tabs or windows were closed, so the most recently closed will be at index 0.

If an error occurs, the promise will be rejected with an error message.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome Full support YesEdge No support NoFirefox Full support 52Opera Full support YesFirefox Android No support No

Legend

Full support  
Full support
No support  
No support

Examples

This code restores the single most recently-closed session, whether it's a tab or a window:

function restoreMostRecent(sessionInfos) {
  if (!sessionInfos.length) {
    console.log("No sessions found")
    return;
  }
  let sessionInfo = sessionInfos[0];
  if (sessionInfo.tab) {
    browser.sessions.restore(sessionInfo.tab.sessionId);
  } else {
    browser.sessions.restore(sessionInfo.window.sessionId);
  }
}

function onError(error) {
  console.log(error);
}

browser.browserAction.onClicked.addListener(function() {
  var gettingSessions = browser.sessions.getRecentlyClosed({
    maxResults: 1
  });
  gettingSessions.then(restoreMostRecent, onError);
});

Acknowledgements

This API is based on Chromium's chrome.sessions API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

Contributors to this page: wbamberg
Last updated by: wbamberg,