Descrizione
Utilizza l'API chrome.sessions
per eseguire query e ripristinare schede e finestre da una sessione di navigazione.
Autorizzazioni
sessions
Tipi
Device
Proprietà
-
deviceName
stringa
Il nome del dispositivo esterno.
-
sessioni
Sessione[]
Un elenco di sessioni a finestre aperte per il dispositivo esterno, ordinate dalla sessione modificata più di recente a quella modificata meno di recente.
Filter
Proprietà
-
maxResults
numero facoltativo
Il numero massimo di voci da recuperare nell'elenco richiesto. Ometti questo parametro per recuperare il numero massimo di voci (
sessions.MAX_SESSION_RESULTS
).
Session
Proprietà
-
lastModified
numero
Il tempo in cui la finestra o la scheda è stata chiusa o modificata, rappresentata in millisecondi dall'epoca.
-
tab
Scheda facoltativa
Il
tabs.Tab
, se questa voce descrive una scheda. Verrà impostato questo valore osessions.Session.window
. -
finestra
Finestra facoltativa
Il
windows.Window
, se questa voce descrive una finestra. Verrà impostato questo valore osessions.Session.tab
.
Proprietà
MAX_SESSION_RESULTS
Il numero massimo di sessions.Session
che verranno inclusi in un elenco richiesto.
Valore
25
Metodi
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Recupera tutti i dispositivi con sessioni sincronizzate.
Parametri
-
filtro
Filtro facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(devices: Device[]) => void
-
dispositivi
L'elenco di oggetti
sessions.Device
per ogni sessione sincronizzata, ordinati in base al dispositivo con la sessione modificata più di recente a quello con la sessione modificata meno di recente. Gli oggettitabs.Tab
sono ordinati per data più recente nell'elementowindows.Window
degli oggettisessions.Session
.
-
Resi
-
Prometti <dispositivo[]>
Chrome 96 e versioni successive .Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Consente di recuperare l'elenco di schede e/o finestre chiuse di recente.
Parametri
-
filtro
Filtro facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(sessions: Session[]) => void
-
sessioni
Sessione[]
L'elenco di voci chiuse in ordine inverso rispetto alla chiusura (la scheda o la finestra chiusa più di recente sarà all'indice
0
). Le voci possono contenere schede o finestre.
-
Resi
-
Promessa<sessione[]>
Chrome 96 e versioni successive .Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Riapre una windows.Window
o tabs.Tab
, con un callback facoltativo da eseguire dopo che la voce è stata ripristinata.
Parametri
-
sessionId
stringa facoltativo
La
windows.Window.sessionId
o l'tabs.Tab.sessionId
da ripristinare. Se questo parametro non viene specificato, viene ripristinata la sessione chiusa più di recente. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(restoredSession: Session) => void
-
restoredSession
Un elemento
sessions.Session
contenente l'oggettowindows.Window
otabs.Tab
ripristinato.
-
Resi
-
Promise<Session>
Chrome 96 e versioni successive .Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.
Eventi
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Attivato quando vengono modificate schede e/o finestre chiuse di recente. Questo evento non monitora le modifiche alle sessioni sincronizzate.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:() => void