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

  Sessão[]

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

Filter

Propriedades

• maxResults

  número opcional

  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

  number

  A hora em que a janela ou guia foi fechada ou modificada, representada em milissegundos desde o período.

• tab

  Guia opcional

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

• janela

  Janela opcional

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

Propriedades

MAX_SESSION_RESULTS

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

Valor

25

Métodos

getDevices()

Promessa

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

Recupera todos os dispositivos com sessões sincronizadas.

Parâmetros

• filtro

  Filtro opcional

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (devices: Device[]) => void

  • dispositivo

    Dispositivo[]

    A lista de objetos sessions.Device para cada sessão sincronizada, classificadas em ordem do dispositivo com a sessão modificada mais recentemente até o dispositivo com a sessão menos modificada recentemente. Objetos tabs.Tab são classificados por tempo para retorno no windows.Window dos objetos sessions.Session.

Retorna

• Promessa<Dispositivo[]>

  Chrome 96 ou versão mais recente

  O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getRecentlyClosed()

Promessa

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

Parâmetros

• filtro

  Filtro opcional

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (sessions: Session[]) => void

  • sessões

    Sessão[]

    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

• Promessa<Session[]>

  Chrome 96 ou versão mais recente

  O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

restore()

Promessa

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

Parâmetros

• sessionId

  string opcional

  O windows.Window.sessionId ou tabs.Tab.sessionId a ser restaurado. Se esse parâmetro não for especificado, a sessão encerrada mais recentemente será restaurada.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (restoredSession: Session) => void

  • restoredSession

    Sessão

    Um sessions.Session contendo o objeto windows.Window ou tabs.Tab restaurado.

Retorna

• Promise&lt;Session&gt;

  Chrome 96 ou versão mais recente

  O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

Eventos

onChanged

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

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

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  () => void