Spec-Zone.ru › Web Extensions

sessions.getRecentlyClosed()

Возвращает массив объектов Session, представляющих окна и вкладки, закрытые в текущей сессии браузера (то есть, с момента запуска браузера).

Это асинхронная функция, которая возвращает Promise.

Синтаксис

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

Параметры

filter Необязательно

object. Объект sessions.Filter, который ограничивает набор возвращаемых сессий.

Возвращаемое значение

A Promise. Значение будет выполнено с массивом объектов Session, по одному для каждой из недавно закрытых вкладок или окон в текущей сессии браузера, до sessions.MAX_SESSION_RESULTS или количества, указанного в аргументе filter, в зависимости от наименьшего значения. Массив предоставляется в обратном порядке закрытия вкладок или окон, поэтому последняя закрытая будет находиться под индексом 0.

Если произошла ошибка, промис будет отклонен с сообщением об ошибке.

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
getRecentlyClosed Да 79 52 ? Да Нет ? ? Нет ? Нет ?

Примеры

Этот код восстанавливает единственную последнюю закрытую сессию, будь то вкладка или окно:

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

Примечание: Этот API основан на API chrome.sessions Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/sessions/getRecentlyClosed

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API