chrome.sessions

refresh date: 2026-09-25 robots: noindex

Opis

Używaj interfejsu API chrome.sessions do wysyłania zapytań oraz przywracania kart i okien z sesji przeglądania.

Uprawnienia

sessions

Typy

Device

Właściwości

• deviceName

  tekst

  Nazwa urządzenia zewnętrznego.

• – sesje

  Session[]

  Lista sesji otwartych okien na urządzeniu zewnętrznym, posortowana od ostatnio do najdawniej zmodyfikowanej sesji.

Filter

Właściwości

• maxResults

  number optional

  Maksymalna liczba wpisów do pobrania na żądanej liście. Pomiń ten parametr, aby pobrać maksymalną liczbę wpisów (sessions.MAX_SESSION_RESULTS).

Session

Właściwości

• lastModified

  liczba

  Czas zamknięcia lub zmodyfikowania okna lub karty, wyrażony w sekundach od początku epoki.

• karta

  Tab opcjonalny

  tabs.Tab, jeśli ten wpis opisuje kartę. Ustawiana jest ta wartość lub sessions.Session.window.

• okno

  Window opcjonalny

  windows.Window, jeśli ten wpis opisuje okno. Ustawiana jest ta wartość lub sessions.Session.tab.

Właściwości

MAX_SESSION_RESULTS

Maksymalna liczba elementów sessions.Session, które zostaną uwzględnione na liście, o którą wysłano prośbę.

Wartość

25

Metody

getDevices()

Obietnica

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

Pobiera wszystkie urządzenia ze zsynchronizowanymi sesjami.

Parametry

• filtr

  Filtr opcjonalny

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (devices: Device[]) => void

  • urządzenia

    Device[]

    Lista obiektów sessions.Device dla każdej zsynchronizowanej sesji, posortowana od urządzenia z ostatnio zmodyfikowaną sesją do urządzenia z sesją zmodyfikowaną najdawniej. Obiekty tabs.Tab są sortowane według daty w polu windows.Window obiektów sessions.Session.

Zwroty

• Promise<Device[]>

  Chrome 96 lub nowsza wersja

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getRecentlyClosed()

Obietnica

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

Pobiera listę ostatnio zamkniętych kart lub okien.

Parametry

• filtr

  Filtr opcjonalny

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (sessions: Session[]) => void

  • – sesje

    Session[]

    Lista zamkniętych wpisów w odwrotnej kolejności, w jakiej zostały zamknięte (ostatnio zamknięta karta lub ostatnio zamknięte okno będzie mieć indeks 0). Wpisy mogą zawierać karty lub okna.

Zwroty

• Promise<Session[]>

  Chrome 96 lub nowsza wersja

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

restore()

Obietnica

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

Ponownie otwiera windows.Window lub tabs.Tab z opcjonalnym wywołaniem zwrotnym, które ma zostać uruchomione po przywróceniu wpisu.

Parametry

• sessionId

  ciąg znaków opcjonalny

  windows.Window.sessionId lub tabs.Tab.sessionId, które chcesz przywrócić. Jeśli ten parametr nie jest określony, przywracana jest ostatnio zamknięta sesja.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (restoredSession: Session) => void

  • restoredSession

    Sesja

    sessions.Session zawierający przywrócony obiekt windows.Window lub tabs.Tab.

Zwroty

• Promise<Session>

  Chrome 96 lub nowsza wersja

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onChanged

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

Uruchamiane, gdy zmienią się ostatnio zamknięte karty lub okna. To zdarzenie nie monitoruje zmian w zsynchronizowanych sesjach.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  () => void