chrome.sessions

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

  Sesión

  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 o sessions.Session.window.

• ventana

  Ventana opcional

  El windows.Window, si esta entrada describe una ventana Se establecerá esto o sessions.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()

Promesa

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

    Dispositivo

    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 objetos tabs.Tab se ordenan según la fecha más reciente en el windows.Window de los objetos sessions.Session.

Devuelve

• Promesa<Device[]>

  Chrome 96 y versiones posteriores

  Las 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()

Promesa

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

    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 posteriores

  Las 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()

Promesa

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 o tabs.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

    Sesión

    Un objeto sessions.Session que contiene el objeto windows.Window o tabs.Tab restablecido.

Devuelve

• Promesa<Sesión>

  Chrome 96 y versiones posteriores

  Las 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