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 ousessions.Session.window
serão definidos. -
janela
Janela opcional
O
windows.Window
, se essa entrada descrever uma janela. Isso ousessions.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()
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
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. Objetostabs.Tab
são classificados por tempo para retorno nowindows.Window
dos objetossessions.Session
.
-
Retorna
-
Prometer<Dispositivo[]>
Chrome 96 ou mais recentePromessas 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()
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 recentePromessas 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()
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
outabs.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
Uma
sessions.Session
contendo o objetowindows.Window
outabs.Tab
restaurado.
-
Retorna
-
Promise<Session>
Chrome 96 ou mais recentePromessas 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