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
cadena
El nombre del dispositivo extranjero.
-
sesiones
Una lista de las sesiones de ventana abiertas para el dispositivo externo, ordenadas de la sesión modificada más recientemente a la menos 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
Tab opcional
El
tabs.Tab
, si esta entrada describe una pestaña Se establecerá esto osessions.Session.window
. -
ventana
Ventana opcional
El
windows.Window
, si esta entrada describe una ventana Se establecerá esto osessions.Session.tab
.
Propiedades
MAX_SESSION_RESULTS
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
de cada sesión sincronizada, ordenada en orden desde el dispositivo con la sesión modificada más reciente hasta el dispositivo con la sesión modificada menos recientemente. Los objetostabs.Tab
se ordenan según la fecha más reciente en elwindows.Window
de los objetossessions.Session
.
-
Devuelve
-
Promesa<Device[]>
Chrome 96 y versiones posterioresLas promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Obtiene la lista de 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 orden inverso (la pestaña o ventana cerrada más recientemente estará en el índice
0
). Las entradas pueden contener pestañas o ventanas.
-
Devuelve
-
Promesa<Session[]>
Chrome 96 y versiones posterioresLas promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Vuelve a abrir un windows.Window
o un tabs.Tab
, con una devolución de llamada opcional para ejecutar cuando se restablezca la entrada.
Parámetros
-
sessionId
cadena opcional
windows.Window.sessionId
otabs.Tab.sessionId
para 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
Un objeto
sessions.Session
que contiene el objetowindows.Window
otabs.Tab
restablecido.
-
Devuelve
-
Promesa<Sesión>
Chrome 96 y versiones posterioresLas promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.
Eventos
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
Se activa cuando se cambian las pestañas o ventanas cerradas recientemente. Este evento no supervisa los cambios de las sesiones sincronizadas.
Parámetros
-
callback
la función
El parámetro
callback
se ve de la siguiente manera:() => void