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

    string

    Es el nombre del dispositivo externo.

  • sesiones

    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 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

Es la cantidad máxima de sessions.Session que se incluirá 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

      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 objetos tabs.Tab se ordenan según la actualidad en windows.Window de los objetos sessions.Session.

Muestra

  • Promise<Device[]>

    Chrome 96 y versiones posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones 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

      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 posteriores

    Las promesas solo son compatibles con Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

restore()

Promesa
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

Muestra

  • Promise<Session>

    Chrome 96 y versiones posteriores

    Las 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