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
js
let gettingSessions = browser.sessions.getRecentlyClosed(
filter // optional object
)
Parameters
filter
Optional-
object
. Asessions.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
BCD tables only load in the browser
Examples
This code restores the single most recently-closed session, whether it's a tab or a window:
js
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(() => {
let gettingSessions = browser.sessions.getRecentlyClosed({
maxResults: 1
});
gettingSessions.then(restoreMostRecent, onError);
});
Note: This API is based on Chromium's chrome.sessions
API.