Descripción
Usa la API de chrome.sessions
para consultar y restablecer pestañas y ventanas de una sesión de navegación.
Permisos
sessions
Tipos
Device
Propiedades
-
deviceName
string
El nombre del dispositivo externo.
-
sesiones
Una lista de sesiones de ventana abierta para el dispositivo externo, ordenadas desde la sesión modificada hasta la más reciente.
Filter
Propiedades
-
maxResults
número opcional
La cantidad máxima de entradas que se recuperarán en la lista solicitada. Omite este parámetro para recuperar la cantidad máxima de entradas (
sessions.MAX_SESSION_RESULTS
).
Session
Propiedades
-
lastModified
número
El tiempo en que se cerró o modificó la ventana o pestaña, representado en milisegundos desde el ciclo de entrenamiento.
-
tab
Pestaña opcional
El objeto
tabs.Tab
, si esta entrada describe una pestaña Se establecerá esto osessions.Session.window
. -
en la ventana modal.
Ventana opcional
El
windows.Window
, si esta entrada describe una ventana Se establecerá esto osessions.Session.tab
.
Propiedades
MAX_SESSION_RESULTS
Es la cantidad máxima de sessions.Session
que se incluirán en una lista solicitada.
Valor
25
Métodos
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
Recupera todos los dispositivos con sesiones sincronizadas.
Parámetros
-
filter
Filtro opcional
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(devices: Device[]) => void
-
dispositivos
La lista de objetos
sessions.Device
para cada sesión sincronizada, ordenados desde el dispositivo con la sesión modificada más recientemente hasta el dispositivo con la sesión modificada menos recientemente. Los objetostabs.Tab
se ordenan según las visitas más recientes en elwindows.Window
de los objetossessions.Session
.
-
Muestra
-
Promesa<Dispositivo[]>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Obtiene la lista de las pestañas o ventanas cerradas recientemente.
Parámetros
-
filter
Filtro opcional
-
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(sessions: Session[]) => void
-
sesiones
La lista de entradas cerradas en el orden inverso en que se cerraron (la pestaña o ventana cerrada más recientemente estará en el índice
0
). Las entradas pueden contener pestañas o ventanas.
-
Muestra
-
Promesa<Sesión[]>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Vuelve a abrir un objeto windows.Window
o tabs.Tab
, con una devolución de llamada opcional que se ejecutará cuando se restablezca la entrada.
Parámetros
-
sessionId
string opcional
El
windows.Window.sessionId
otabs.Tab.sessionId
que se restablecerá. Si no se especifica este parámetro, se restablece la sesión cerrada más recientemente. -
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(restoredSession: Session) => void
-
restoredSession
Una
sessions.Session
que contiene el objetowindows.Window
otabs.Tab
restablecido.
-
Muestra
-
Promise<Session>
Chrome 96 y versiones posterioresLas promesas solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.
Eventos
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Se activa cuando se cambian pestañas o ventanas cerradas recientemente. Este evento no supervisa los cambios de las sesiones sincronizadas.
Parámetros
-
callback
función
El parámetro
callback
se ve de la siguiente manera:() => void