chrome.sessions

Opis

Interfejs API chrome.sessions służy do tworzenia zapytań dotyczących kart i okien z sesji przeglądania oraz do ich przywracania.

Uprawnienia

sessions

Typy

Device

Właściwości

  • deviceName

    string,

    Nazwa obcego urządzenia.

  • sesje

    Sesja[]

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

Filter

Właściwości

  • maxResults

    Liczba opcjonalnie

    Maksymalna liczba pozycji z żądanej listy, które mają zostać pobrane. Pomiń ten parametr, by pobrać maksymalną liczbę wpisów (sessions.MAX_SESSION_RESULTS).

Session

Właściwości

  • lastModified

    Liczba

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

  • tab

    Tab opcjonalnie

    tabs.Tab, jeśli ten wpis opisuje kartę. Wartość ta lub sessions.Session.window zostaną ustawione.

  • okno

    Okno opcjonalnie

    windows.Window, jeśli wpis opisuje okno. Wartość ta lub sessions.Session.tab zostaną ustawione.

Właściwości

MAX_SESSION_RESULTS

Maksymalna liczba sessions.Session, które mogą się znaleźć na żądanej liście.

Wartość

25

Metody

getDevices()

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

Pobiera wszystkie urządzenia ze zsynchronizowanymi sesjami.

Parametry

  • filter

    Filtruj opcjonalnie

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (devices: Device[])=>void

    • urządzenia

      Urządzenie[]

      Lista obiektów sessions.Device w każdej zsynchronizowanej sesji posortowana w kolejności od urządzenia o ostatniej zmodyfikowanej sesji do urządzenia o najmniej ostatnio zmodyfikowanej sesji. Obiekty tabs.Tab są sortowane według czasu od poprzedniej wizyty w windows.Window obiektów sessions.Session.

Akcje powrotne

  • Obietnica<urządzenie[]>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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

  • filter

    Filtruj opcjonalnie

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (sessions: Session[])=>void

    • sesje

      Sesja[]

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

Akcje powrotne

  • Obietnica<sesja[]>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

restore()

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

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

Parametry

Akcje powrotne

  • Obietnica<Sesja>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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 w sesjach.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    ()=>void