chrome.sessions

refresh date: 2026-09-25 robots: noindex

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

  Una lista de sesiones de ventanas abiertas para el dispositivo externo, ordenadas de la sesión modificada más recientemente a la menos reciente.

Filter

Propiedades

• maxResults

  number 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 pestaña, representada en segundos desde la época.

• tabulación

  Pestaña opcional

  El tabs.Tab, si esta entrada describe una pestaña. Se establecerá este campo o sessions.Session.window.

• ventana

  Ventana opcional

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

Promise

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

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

    Es 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 objetos tabs.Tab se ordenan por visitas recientes en el windows.Window de los objetos sessions.Session.

Muestra

• Promise<Device[]>

  Chrome 96 y versiones posteriores

  Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getRecentlyClosed()

Promise

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

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 el 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 se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

restore()

Promise

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

Vuelve a abrir un windows.Window o tabs.Tab, con una devolución de llamada opcional para ejecutar cuando se haya restablecido la entrada.

Parámetros

• sessionId

  string opcional

  windows.Window.sessionId o tabs.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

    Sesión

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

Muestra

• Promise<Session>

  Chrome 96 y versiones posteriores

  Las promesas solo se admiten en 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 en las sesiones sincronizadas.

Parámetros

• callback

  función

  El parámetro callback se ve de la siguiente manera:

  () => void