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

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

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