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 di finestre aperte per il dispositivo esterno, ordinate dalla sessione modificata più di recente a quella modificata meno di recente.

Filter

Proprietà

  • maxResults

    number (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

    L'ora in cui la finestra o la scheda è stata chiusa o modificata, rappresentata in secondi dall'epoca.

  • tab

    Scheda facoltativo

    tabs.Tab, se questa voce descrive una scheda. Verrà impostata questa opzione o sessions.Session.window.

  • finestra

    Finestra facoltativo

    Il windows.Window, se questa voce descrive una finestra. Verrà impostata questa opzione 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()

Promessa 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

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 degli oggetti sessions.Device per ogni sessione sincronizzata, ordinati dal 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 nel windows.Window degli oggetti sessions.Session.

Resi

  • Promise<Device[]>

    Chrome 96+

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

getRecentlyClosed()

Promessa 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

Recupera l'elenco delle schede e/o delle 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 delle voci chiuse in ordine inverso rispetto alla chiusura (l'ultima scheda o finestra chiusa si trova all'indice 0). Le voci possono contenere schede o finestre.

Resi

  • Promise<Session[]>

    Chrome 96+

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

restore()

Promessa 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

Parametri

Resi

  • Promise<Session>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, 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