chrome.sessions

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

sessions

Типы

Device

Свойства

  • deviceName

    string

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

  • sessions

    Сеанс[]

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

Filter

Свойства

  • maxResults

    number (необязательно)

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

Session

Свойства

  • lastModified

    число

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

  • табуляция

    Tab необязательный

    tabs.Tab, если запись описывает вкладку. Будет задано либо это поле, либо sessions.Session.window.

  • окно

    Window необязательный

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

Свойства

MAX_SESSION_RESULTS

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

Значение

25

Методы

getDevices()

Promise 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

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

Параметры

  • фильтр

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

  • обратный вызов

    function необязательно

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

    (devices: Device[]) => void

    • устройства

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

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

Возвраты

  • Promise<Device[]>

    Chrome 96 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getRecentlyClosed()

Promise 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

Возвращает список недавно закрытых вкладок и/или окон.

Параметры

  • фильтр

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

  • обратный вызов

    function необязательно

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

    (sessions: Session[]) => void

    • sessions

      Сеанс[]

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

Возвраты

  • Promise<Session[]>

    Chrome 96 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

restore()

Promise 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

Параметры

  • sessionId

    Строка (необязательно)

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

  • обратный вызов

    function необязательно

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

    (restoredSession: Session) => void

Возвраты

  • Promise<Session>

    Chrome 96 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onChanged

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

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

Параметры

  • обратный вызов

    function

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

    () => void