chrome.sessions

Descrição

Use a API chrome.sessions para consultar e restaurar guias e janelas de uma sessão de navegação.

Permissões

sessions

Tipos

Device

Propriedades

  • deviceName

    string

    O nome do dispositivo externo.

  • sessões

    Session[]

    Uma lista de sessões de janelas abertas para o dispositivo externo, classificada da sessão modificada mais recentemente à menos recente.

Filter

Propriedades

  • maxResults

    number optional

    O número máximo de entradas a serem buscadas na lista solicitada. Omita esse parâmetro para buscar o número máximo de entradas (sessions.MAX_SESSION_RESULTS).

Session

Propriedades

  • lastModified

    número

    O momento em que a janela ou guia foi fechada ou modificada, representado em segundos desde o início da era Unix.

  • tab

    Guia opcional

    O tabs.Tab, se esta entrada descrever uma guia. Este ou sessions.Session.window será definido.

  • janela

    Janela opcional

    O windows.Window, se esta entrada descrever uma janela. Este ou sessions.Session.tab será definido.

Propriedades

MAX_SESSION_RESULTS

O número máximo de sessions.Session que serão incluídos em uma lista solicitada.

Valor

25

Métodos

getDevices()

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

Recupera todos os dispositivos com sessões sincronizadas.

Parâmetros

  • filtrar

    Filtro opcional

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (devices: Device[]) => void

    • dispositivo

      Device[]

      A lista de objetos sessions.Device para cada sessão sincronizada, classificada em ordem do dispositivo com a sessão modificada mais recentemente para o dispositivo com a sessão modificada menos recentemente. Os objetos tabs.Tab são classificados por recência no windows.Window dos objetos sessions.Session.

Retorna

  • Promise<Device[]>

    Chrome 96+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getRecentlyClosed()

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

Recebe a lista de guias e/ou janelas fechadas recentemente.

Parâmetros

  • filtrar

    Filtro opcional

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (sessions: Session[]) => void

    • sessões

      Session[]

      A lista de entradas fechadas na ordem inversa em que foram fechadas. A guia ou janela fechada mais recentemente estará no índice 0. As entradas podem conter guias ou janelas.

Retorna

  • Promise<Session[]>

    Chrome 96+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

restore()

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

Reabre um windows.Window ou tabs.Tab, com um callback opcional para ser executado quando a entrada for restaurada.

Parâmetros

Retorna

  • Promise<Session>

    Chrome 96+

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

Disparado quando guias e/ou janelas fechadas recentemente são alteradas. Esse evento não monitora mudanças nas sessões sincronizadas.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    () => void