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 ustawieniesessions.Session.window
. -
okno
Okno opcjonalne
windows.Window
, jeśli ten wpis opisuje okno. Zostanie ustawione to lub ustawieniesessions.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()
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
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ą. Obiektytabs.Tab
są posortowane według czasu od poprzedniej wizyty wwindows.Window
obiektówsessions.Session
.
-
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()
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()
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
lubtabs.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
sessions.Session
zawierający przywrócony obiektwindows.Window
lubtabs.Tab
.
-
Zwroty
-
Promise<Session>
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