chrome.sessions

Описание

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

Разрешения

sessions

Типы

Device

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

  • имя устройства

    нить

    Имя стороннего устройства.

  • сессии

    Сессия []

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

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,
)

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

Параметры

  • фильтр

    Фильтр опционально

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

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

    Параметр callback выглядит так: 

    (devices: Device[])=>void

    • устройства

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

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

Возврат

  • Обещание < Устройство []>

    Хром 96+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

getRecentlyClosed()

Обещать
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

Параметры

  • фильтр

    Фильтр опционально

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

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

    Параметр callback выглядит так: 

    (sessions: Session[])=>void

    • сессии

      Сессия []

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

Возврат

  • Обещание < Сессия []>

    Хром 96+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

restore()

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

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

Параметры

  • идентификатор сессии

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

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

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

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

    Параметр callback выглядит так: 

    (restoredSession: Session)=>void

Возврат

  • Обещание < Сессия >

    Хром 96+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

События

onChanged

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

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

Параметры

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

    функция

    Параметр callback выглядит так: 

    ()=>void