chrome.sessions

дата обновления: 2026-09-25 robots: noindex

Описание

Используйте API chrome.sessions для запроса и восстановления вкладок и окон из сеанса просмотра.

Разрешения

sessions

Типы

Device

Характеристики

  • deviceName

    нить

    Название иностранного устройства.

  • сессии

    Сессия []

    Список открытых оконных сессий для иностранного устройства, отсортированный от самой последней к наименее недавно измененной.

Filter

Характеристики

  • maxResults

    число необязательно

    Максимальное количество записей, которое необходимо получить из запрошенного списка. Чтобы получить максимальное количество записей, опустите этот параметр ( sessions.MAX_SESSION_RESULTS ).

Session

Характеристики

  • последнееИзменено

    число

    Время закрытия или изменения окна или вкладки, выраженное в секундах с начала эпохи.

  • вкладка

    Вкладка ( необязательно)

    Параметр tabs.Tab , если в этой записи описывается вкладка. Будет установлено либо значение этого параметра, либо значение sessions.Session.window .

  • окно

    Окно (по желанию)

    Если данная запись описывает окно, будет установлено значение windows.Window . Будет установлено либо это значение, либо sessions.Session.tab .

Характеристики

MAX_SESSION_RESULTS

Максимальное количество sessions.Session , которое будет включено в запрошенный список.

Ценить

25

Методы

getDevices()

Обещать
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

Получает список всех устройств с синхронизированными сессиями.

Параметры

  • фильтр

    Фильтр (необязательно)

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (devices: Device[]) => void

    • устройства

      Устройство []

      Список объектов sessions.Device для каждой синхронизированной сессии, отсортированный в порядке от устройства с самой недавно измененной сессией к устройству с наименее недавно измененной сессией. tabs.Tab объекты сортируются по дате добавления в окнах windows.Window объектов sessions.Session .

Возвраты

  • Promise< Устройство []>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getRecentlyClosed()

Обещать
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

Получает список недавно закрытых вкладок и/или окон.

Параметры

  • фильтр

    Фильтр (необязательно)

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (sessions: Session[]) => void

    • сессии

      Сессия []

      Список закрытых записей в обратном порядке их закрытия (самая недавно закрытая вкладка или окно будет иметь индекс 0 ). Записи могут содержать как вкладки, так и окна.

Возвраты

  • Promise< Session []>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

restore()

Обещать
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

Открывает повторно окно windows.Window или tabs.Tab , с необязательным обратным вызовом, который будет выполняться после восстановления записи.

Параметры

  • sessionId

    строка необязательный

    Параметр windows.Window.sessionId или tabs.Tab.sessionId который необходимо восстановить. Если этот параметр не указан, восстанавливается последняя закрытая сессия.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (restoredSession: Session) => void

Возвраты

  • Promise< Session >

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

События

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

Событие срабатывает при изменении недавно закрытых вкладок и/или окон. Это событие не отслеживает изменения синхронизированных сессий.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    () => void