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 lubsessions.Session.window
zostaną ustawione. -
okno
Okno opcjonalnie
windows.Window
, jeśli wpis opisuje okno. Wartość ta lubsessions.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()
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
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. Obiektytabs.Tab
są sortowane według czasu od poprzedniej wizyty wwindows.Window
obiektówsessions.Session
.
-
Akcje powrotne
-
Obietnica<urządzenie[]>
Chrome 96 i nowsze wersjeObietnice 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()
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 wersjeObietnice 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()
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
-
sessionId
ciąg znaków opcjonalny
windows.Window.sessionId
lubtabs.Tab.sessionId
do przywrócenia. Jeśli go nie podasz, zostanie przywrócona ostatnio zamknięta sesja. -
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(restoredSession: Session) => void
-
restoredSession
sessions.Session
zawierający przywrócony obiektwindows.Window
lubtabs.Tab
.
-
Akcje powrotne
-
Obietnica<Sesja>
Chrome 96 i nowsze wersjeObietnice 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