chrome.sessions

Opis

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

Uprawnienia

sessions

Typy

Device

Właściwości

• deviceName

  ciąg znaków

  Nazwa obcego urządzenia.

• – sesje

  Sesja[]

  Lista sesji otwartych okien dla obcego urządzenia, posortowana od ostatniej do najstarszej zmodyfikowanej sesji.

Filter

Właściwości

• maxResults

  liczba opcjonalnie

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

Session

Właściwości

• lastModified

  liczba

  Czas zamknięcia lub modyfikacji okna lub karty wyrażony w milisekundach od początku epoki.

• tabulator

  Opcjonalne Tab

  tabs.Tab, jeśli ten wpis opisuje kartę. Zostanie ustawione to lub ustawienie sessions.Session.window.

• okno

  Okno opcjonalne

  windows.Window, jeśli ten wpis opisuje okno. Zostanie ustawione to lub ustawienie sessions.Session.tab.

Właściwości

MAX_SESSION_RESULTS

Maksymalna liczba elementów sessions.Session, które zostaną uwzględnione na żądanej liście.

Wartość

25

Metody

getDevices()

Obietnica .

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

Pobiera wszystkie urządzenia ze zsynchronizowanymi sesjami.

Parametry

• filtr

  Filtr opcjonalny

• wywołanie zwrotne

  funkcja optional

  Parametr callback wygląda tak:

  (devices: Device[]) => void

  • urządzenia

    Urządzenie[]

    Lista obiektów sessions.Device dla każdej zsynchronizowanej sesji, posortowana od urządzenia z ostatnio zmodyfikowaną sesją do urządzenia z najmniej zmodyfikowaną sesją. Obiekty tabs.Tab są posortowane według czasu od poprzedniej wizyty w windows.Window obiektów sessions.Session.

Zwroty

• Obietnica<Urządzenie[]>

  Chrome w wersji 96 lub nowszej, .

  Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getRecentlyClosed()

Obietnica .

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

Pobiera listę ostatnio zamkniętych kart lub okien.

Parametry

• filtr

  Filtr opcjonalny

• wywołanie zwrotne

  funkcja optional

  Parametr callback wygląda tak:

  (sessions: Session[]) => void

  • – sesje

    Sesja[]

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

Zwroty

• Obietnica<Sesja[]>

  Chrome w wersji 96 lub nowszej, .

  Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

restore()

Obietnica .

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

Parametry

• sessionId

  ciąg znaków opcjonalny

  windows.Window.sessionId lub tabs.Tab.sessionId do przywrócenia. Jeśli nie określisz tego parametru, przywrócona zostanie ostatnio zamknięta sesja.

• wywołanie zwrotne

  funkcja optional

  Parametr callback wygląda tak:

  (restoredSession: Session) => void

  • restoredSession

    Sesja

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

Zwroty

• Promise&lt;Session&gt;

  Chrome w wersji 96 lub nowszej, .

  Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onChanged

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

Uruchamiane po zmianie ostatnio zamkniętych kart lub okien. To zdarzenie nie monitoruje zsynchronizowanych zmian sesji.

Parametry

• wywołanie zwrotne

  funkcja

  Parametr callback wygląda tak:

  () => void