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
Session[]
Un elenco di sessioni delle finestre aperte per il dispositivo esterno, ordinate dalla sessione modificata più di recente a quella modificata meno di recente.
Filter
Proprietà
-
maxResults
number 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
L'ora in cui la finestra o la scheda è stata chiusa o modificata, rappresentata in secondi dall'epoca.
-
tab
Tab facoltativo
tabs.Tab
, se questa voce descrive una scheda. Verrà impostato questo valore osessions.Session.window
. -
finestra
Finestra facoltativa
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
function facoltativa
Il parametro
callback
ha il seguente aspetto:(devices: Device[]) => void
-
dispositivi
L'elenco di oggetti
sessions.Device
per ogni sessione sincronizzata, ordinato dal dispositivo con la sessione modificata più di recente a quello con la sessione modificata meno di recente. Gli oggettitabs.Tab
sono ordinati in base all'anzianità nel campowindows.Window
degli oggettisessions.Session
.
-
Resi
-
Promise<Device[]>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Recupera l'elenco delle schede e/o finestre chiuse di recente.
Parametri
-
filtro
Filtro facoltativo
-
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(sessions: Session[]) => void
-
sessioni
Session[]
L'elenco delle voci chiuse nell'ordine inverso in cui sono state chiuse (la scheda o la finestra chiusa più di recente sarà all'indice
0
). Le voci possono contenere schede o finestre.
-
Resi
-
Promise<Session[]>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Riapre un windows.Window
o un tabs.Tab
, con un callback facoltativo da eseguire quando la voce è stata ripristinata.
Parametri
-
sessionId
stringa facoltativa
windows.Window.sessionId
otabs.Tab.sessionId
da ripristinare. Se questo parametro non è specificato, viene ripristinata la sessione chiusa più di recente. -
callback
function facoltativa
Il parametro
callback
ha il seguente aspetto:(restoredSession: Session) => void
-
restoredSession
Un
sessions.Session
contenente l'oggettowindows.Window
otabs.Tab
ripristinato.
-
Resi
-
Promise<Session>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.
Eventi
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Viene attivato quando le schede e/o le finestre chiuse di recente vengono modificate. Questo evento non monitora le modifiche delle sessioni sincronizzate.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:() => void