sessions.restore()

Stellt einen geschlossenen Tab oder ein geschlossenes Fenster wieder her. Das Wiederherstellen öffnet nicht nur den Tab oder das Fenster erneut, sondern stellt auch die Navigationshistorie des Tabs wieder her, sodass die Vorwärts-/Rückwärts-Schaltflächen funktionieren. Das Wiederherstellen eines Fensters stellt alle Tabs wieder her, 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 Fenster oder den Tab enthält, der wiederhergestellt werden soll. Dies kann in der sessionId-Eigenschaft des Tab oder Window Objekts gefunden werden, die in der Session enthalten ist, die von sessions.getRecentlyClosed() zurückgegeben wird.

Rückgabewert

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
restore

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

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

Hinweis: Diese API basiert auf der chrome.sessions API von Chromium.

Bekannte Probleme

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