sessions.getRecentlyClosed()
Gibt ein Array von Session
Objekten zurück, die Fenster und Tabs darstellen, die in der aktuellen Browsersitzung geschlossen wurden (also: die Zeit, seit der der Browser gestartet wurde).
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let gettingSessions = browser.sessions.getRecentlyClosed(
filter // optional object
)
Parameter
filter
Optional-
object
. Einsessions.Filter
Objekt, das die Menge der zurückgegebenen Sitzungen einschränkt.
Rückgabewert
Ein Promise
. Dieses wird mit einem Array von Session
Objekten erfüllt werden, eines für jeden der zuletzt geschlossenen Tabs oder Fenster in der aktuellen Browsersitzung, bis zu sessions.MAX_SESSION_RESULTS
oder der Anzahl, die im Argument filter
enthalten ist, je nachdem, welche Zahl kleiner ist. Das Array wird in umgekehrter Reihenfolge der Schließung der Tabs oder Fenster angegeben, sodass der zuletzt geschlossene Eintrag bei Index 0 steht.
Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispiele
Dieser Code stellt die zuletzt geschlossene Sitzung wieder her, unabhängig davon, ob es sich um einen Tab oder ein Fenster handelt:
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);
});
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.sessions
API von Chromium.