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 straniero.
-
sessioni
Sessione[]
Un elenco di sessioni di finestra aperta per il dispositivo straniero, ordinate dalla sessione modificata più di recente a quella meno 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 momento in cui la finestra o la scheda è stata chiusa o modificata, espressa in millisecondi dall'epoca.
-
Home
Scheda facoltativa
Il
tabs.Tab
, se questa voce descrive una scheda. Verrà impostato questo osessions.Session.window
. -
finestra
Finestra facoltativa
Il
windows.Window
, se questa voce descrive una finestra. Verrà impostato questo osessions.Session.tab
.
Proprietà
MAX_SESSION_RESULTS
Il numero massimo di sessions.Session
che sarà incluso in un elenco richiesto.
Valore
25
Metodi
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Recupera tutti i dispositivi con sessioni sincronizzate.
Parametri
-
filter
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 dal dispositivo con la sessione modificata più di recente al dispositivo con la sessione modificata meno di recente.tabs.Tab
oggetti sono ordinati per recency nella sezionewindows.Window
disessions.Session
oggetti.
-
Ritorni
-
Promessa<Dispositivo[]>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Recupera l'elenco delle schede e/o delle finestre chiuse di recente.
Parametri
-
filter
Filtro facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(sessions: Session[]) => void
-
sessioni
Sessione[]
L'elenco delle voci chiuse in ordine inverso in cui sono state chiuse (la scheda o la finestra chiusa più di recente si troverà nell'indice
0
). Le voci possono contenere schede o finestre.
-
Ritorni
-
Promessa<Sessione[]>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Riapre un oggetto windows.Window
o tabs.Tab
, con un callback facoltativo da eseguire quando la voce è stata ripristinata.
Parametri
-
sessionId
stringa facoltativo
windows.Window.sessionId
otabs.Tab.sessionId
da ripristinare. Se questo parametro non viene specificato, viene ripristinata l'ultima sessione chiusa. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(restoredSession: Session) => void
-
restoredSession
Una
sessions.Session
contenente l'oggettowindows.Window
otabs.Tab
ripristinato.
-
Ritorni
-
Promessa<Sessione>
Chrome 96 e versioni successiveLe promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso 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