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

• sessions

  Sessão[]

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

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.

• .

  Guia opcional

  O tabs.Tab, se essa entrada descreve uma guia. Isso ou sessions.Session.window serão definidos.

• janela

  Janela opcional

  O windows.Window, se essa entrada descrever uma janela. Isso ou sessions.Session.tab serão definidos.

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

• Função filter

  Filter opcional

• callback

  função optional

  O parâmetro callback tem esta aparência:

  (devices: Device[])=>void

  • dispositivo

    Dispositivo[]

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

Retorna

• Prometer<Dispositivo[]>

  Chrome 96 ou mais recente

  Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

getRecentlyClosed()

Promessa

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

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

Parâmetros

• Função filter

  Filter opcional

• callback

  função optional

  O parâmetro callback tem esta aparência:

  (sessions: Session[])=>void

  • sessions

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

  Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

restore()

Promessa

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

Reabre uma 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 ele não for especificado, a sessão encerrada mais recentemente será restaurada.

• callback

  função optional

  O parâmetro callback tem esta aparência:

  (restoredSession: Session)=>void

  • restoredSession

    Sessão

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

Retorna

• Promise<Session>

  Chrome 96 ou mais recente

  Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

Eventos

onChanged

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

Disparado quando as 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