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

Zwroty

  • Obietnica<Urządzenie[]>

    Chrome w wersji 96 lub nowszej, .

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

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 w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

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

Zwroty

  • Promise&lt;Session&gt;

    Chrome w wersji 96 lub nowszej, .

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

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