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, classificadas da sessão mais recente para a menos recente.
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
número
O horário 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 a entrada descrever uma guia. Ou isso ousessions.Session.window
será definido. -
janela
Janela opcional
windows.Window
, se essa entrada descrever uma janela. Ou isso ousessions.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()
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 este formato:(devices: Device[]) => void
-
dispositivo
A lista de objetos
sessions.Device
para cada sessão sincronizada, classificada em ordem do dispositivo com a sessão mais recente para o dispositivo com a sessão menos recente. Os objetostabs.Tab
são classificados por recência nowindows.Window
dos objetossessions.Session
.
-
Retorna
-
Promise<Device[]>
Chrome 96 e versões mais recentesAs promessas têm suporte no Manifest V3 e versões mais recentes, mas os 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 transmitido para o callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
Recebe a lista de guias e/ou janelas fechadas recentemente.
Parâmetros
Retorna
-
Promise<Session[]>
Chrome 96 e versões mais recentesAs promessas têm suporte no Manifest V3 e versões mais recentes, mas os 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 transmitido para o callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
Reabre um windows.Window
ou tabs.Tab
, com um callback opcional para executar quando a entrada for restaurada.
Parâmetros
-
sessionId
string opcional
windows.Window.sessionId
outabs.Tab.sessionId
para restaurar. Se esse parâmetro não for especificado, a sessão mais recente será restaurada. -
callback
função opcional
O parâmetro
callback
tem este formato:(restoredSession: Session) => void
-
restoredSession
Um
sessions.Session
contendo o objetowindows.Window
outabs.Tab
restaurado.
-
Retorna
-
Promise<Session>
Chrome 96 e versões mais recentesAs promessas têm suporte no Manifest V3 e versões mais recentes, mas os 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 transmitido para o callback.
Eventos
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
É acionado quando as guias e/ou janelas fechadas recentemente são alteradas. Esse evento não monitora as mudanças nas sessões sincronizadas.
Parâmetros
-
callback
função
O parâmetro
callback
tem este formato:() => void