chrome.sessions

Описание

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

Разрешения

sessions

Типы

Device

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

  • Имя_устройства

    нить

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

  • сеансы

    Сессия []

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

Filter

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

  • maxResults

    номер необязательно

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

Session

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

  • lastModified

    число

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

  • вкладка

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

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

  • окно

    Окно опционально

    Если эта запись описывает окно, то значение windows.Window . Будет задано либо this, либо 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 . Объекты сеанса.

Возврат

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

    Хром 96+

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

getRecentlyClosed()

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

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

Параметры

  • фильтр

    Фильтр необязательный

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

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

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

    (sessions: Session[]) => void

    • сеансы

      Сессия []

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

Возврат

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

    Хром 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

Возврат

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

    Хром 96+

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

События

onChanged

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

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

Параметры

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

    функция

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

    () => void