sessions.restore()

Stellt einen geschlossenen Tab oder ein Fenster wieder her. Das Wiederherstellen öffnet nicht nur den Tab oder das Fenster erneut, sondern stellt auch den Navigationsverlauf des Tabs wieder her, sodass die Vor-/Zurück-Tasten funktionieren. Das Wiederherstellen eines Fensters wird alle Tabs wiederherstellen, die das Fenster beim Schließen enthielt.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let restoringSession = browser.sessions.restore(
  sessionId             // string
)

Parameter

sessionId

string. Ein String, der die Sitzungs-ID für das wiederherzustellende Fenster oder den Tab enthält. Diese kann in der sessionId-Eigenschaft des Tab oder Window Objekts im Session gefunden werden, das von sessions.getRecentlyClosed() zurückgegeben wird.

Rückgabewert

Ein Promise. Dieses wird mit einem Session Objekt erfüllt, das die wiederhergestellte Sitzung repräsentiert.

Beispiele

Dies stellt die zuletzt geschlossene Sitzung wieder her, unabhängig davon, ob es sich um ein Fenster oder einen Tab handelt:

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);
});

Browser-Kompatibilität

Hinweis: Dieses API basiert auf Chromium's chrome.sessions API.

Bekannte Probleme

Bug 1538119 - Doppelte sessionId in browser.sessions.getRecentlyClosed() nach "Vorherige Sitzung wiederherstellen"