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
Es el nombre del dispositivo externo.
-
sesiones
Sesión[]
Es una lista de sesiones de ventanas abiertas para el dispositivo externo, ordenadas de la sesión más reciente a la menos reciente.
Filter
Propiedades
-
maxResults
número opcional
Es 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
Es la hora en que se cerró o modificó la ventana o la pestaña, representada en segundos desde la época.
-
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
Es la cantidad máxima de sessions.Session
que se incluirá 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
Device[]
Es la lista de objetos
sessions.Device
para cada sesión sincronizada, ordenados del dispositivo con la sesión modificada más recientemente al dispositivo con la sesión modificada menos recientemente. Los objetostabs.Tab
se ordenan según la actualidad enwindows.Window
de los objetossessions.Session
.
-
Muestra
-
Promise<Device[]>
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 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
Sesión[]
Es la lista de entradas cerradas en orden inverso al 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
-
Promise<Session[]>
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 windows.Window
o tabs.Tab
, con una devolución de llamada opcional para ejecutar cuando se restablezca la entrada.
Parámetros
-
sessionId
cadena 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 reciente. -
callback
función opcional
El parámetro
callback
se ve de la siguiente manera:(restoredSession: Session) => void
-
restoredSession
Un
sessions.Session
que contiene el objetowindows.Window
otabs.Tab
restaurado.
-
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 las 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