Opis
Użyj interfejsu chrome.sessions
API, aby wysyłać zapytania i przywracać karty oraz okna z sesji przeglądania.
Uprawnienia
sessions
Typy
Device
Właściwości
-
deviceName
ciąg znaków
Nazwa urządzenia zewnętrznego.
-
– sesje
Session[]
Lista otwartych sesji okien na obcym urządzeniu, posortowana od ostatnio do najdawniej zmodyfikowanej sesji.
Filter
Właściwości
-
maxResults
number opcjonalny
Maksymalna liczba wpisów do pobrania z żądanej listy. Aby pobrać maksymalną liczbę wpisów (
sessions.MAX_SESSION_RESULTS
), pomiń ten parametr.
Session
Właściwości
-
lastModified
liczba
Czas zamknięcia lub zmodyfikowania okna lub karty w sekundach od początku epoki.
-
tabulator
Tab opcjonalny
tabs.Tab
, jeśli ten wpis opisuje kartę. Ustawiona będzie ta wartość lubsessions.Session.window
. -
okno
Window opcjonalny
windows.Window
, jeśli wpis dotyczy okna. Ustawiona będzie ta wartość lubsessions.Session.tab
.
Właściwości
MAX_SESSION_RESULTS
Maksymalna liczba sessions.Session
, które zostaną uwzględnione na żądanej liście.
Wartość
25
Metody
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
): Promise<Device[]>
Pobiera wszystkie urządzenia ze zsynchronizowanymi sesjami.
Parametry
-
filtr
Filtr opcjonalny
-
callback
funkcja opcjonalna
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 najdawniej zmodyfikowaną sesją. Obiektytabs.Tab
są sortowane według daty wwindows.Window
obiektówsessions.Session
.
-
Zwroty
-
Promise<Device[]>
Chrome w wersji 96 lub nowszejObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
): Promise<Session[]>
Pobiera listę ostatnio zamkniętych kart lub okien.
Parametry
Zwroty
-
Promise<Session[]>
Chrome w wersji 96 lub nowszejObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
): Promise<Session>
Ponownie otwiera windows.Window
lub tabs.Tab
z opcjonalnym wywołaniem zwrotnym, które ma zostać uruchomione po przywróceniu wpisu.
Parametry
-
sessionId
string opcjonalny
windows.Window.sessionId
lubtabs.Tab.sessionId
, aby przywrócić. Jeśli ten parametr nie zostanie podany, zostanie przywrócona ostatnio zamknięta sesja. -
callback
funkcja opcjonalna
Parametr
callback
wygląda tak:(restoredSession: Session) => void
-
restoredSession
Obiekt
sessions.Session
zawierający przywrócony obiektwindows.Window
lubtabs.Tab
.
-
Zwroty
-
Promise<Session>
Chrome w wersji 96 lub nowszejObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.
Wydarzenia
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Wywoływane, gdy ostatnio zamknięte karty lub okna zostaną zmienione. To zdarzenie nie monitoruje zmian w sesjach zsynchronizowanych.
Parametry
-
callback
funkcja
Parametr
callback
wygląda tak:() => void