chrome.sessions

Descrizione

Utilizza l'API chrome.sessions per eseguire query e ripristinare schede e finestre da una sessione di navigazione.

Autorizzazioni

sessions

Tipi

Device

Proprietà

  • deviceName

    stringa

    Il nome del dispositivo esterno.

  • sessioni

    Sessione[]

    Un elenco di sessioni a finestre aperte per il dispositivo esterno, ordinate dalla sessione modificata più di recente a quella modificata meno di recente.

Filter

Proprietà

  • maxResults

    numero facoltativo

    Il numero massimo di voci da recuperare nell'elenco richiesto. Ometti questo parametro per recuperare il numero massimo di voci (sessions.MAX_SESSION_RESULTS).

Session

Proprietà

  • lastModified

    numero

    Il tempo in cui la finestra o la scheda è stata chiusa o modificata, rappresentata in millisecondi dall'epoca.

  • tab

    Scheda facoltativa

    Il tabs.Tab, se questa voce descrive una scheda. Verrà impostato questo valore o sessions.Session.window.

  • finestra

    Finestra facoltativa

    Il windows.Window, se questa voce descrive una finestra. Verrà impostato questo valore o sessions.Session.tab.

Proprietà

MAX_SESSION_RESULTS

Il numero massimo di sessions.Session che verranno inclusi in un elenco richiesto.

Valore

25

Metodi

getDevices()

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

Recupera tutti i dispositivi con sessioni sincronizzate.

Parametri

  • filtro

    Filtro facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (devices: Device[]) => void

    • dispositivi

      Dispositivo[]

      L'elenco di oggetti sessions.Device per ogni sessione sincronizzata, ordinati in base al dispositivo con la sessione modificata più di recente a quello con la sessione modificata meno di recente. Gli oggetti tabs.Tab sono ordinati per data più recente nell'elemento windows.Window degli oggetti sessions.Session.

Resi

  • Prometti <dispositivo[]>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getRecentlyClosed()

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

Consente di recuperare l'elenco di schede e/o finestre chiuse di recente.

Parametri

  • filtro

    Filtro facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (sessions: Session[]) => void

    • sessioni

      Sessione[]

      L'elenco di voci chiuse in ordine inverso rispetto alla chiusura (la scheda o la finestra chiusa più di recente sarà all'indice 0). Le voci possono contenere schede o finestre.

Resi

  • Promessa<sessione[]>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

restore()

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

Riapre una windows.Window o tabs.Tab, con un callback facoltativo da eseguire dopo che la voce è stata ripristinata.

Parametri

Resi

  • Promise&lt;Session&gt;

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onChanged

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

Attivato quando vengono modificate schede e/o finestre chiuse di recente. Questo evento non monitora le modifiche alle sessioni sincronizzate.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void