chrome.sessions

refresh date: 2026-09-25 robots: noindex

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

    Session[]

    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 optional

    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'epoch.

  • tab

    Tab facoltativo

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

  • finestra

    Window facoltativo

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

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

Recupera tutti i dispositivi con sessioni sincronizzate.

Parametri

  • filtro

    Filtro facoltativo

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (devices: Device[]) => void

    • dispositivi

      Dispositivo[]

      L'elenco di 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 in base alla data di creazione più recente nel campo windows.Window degli oggetti sessions.Session.

Resi

  • Promise<Device[]>

    Chrome 96 e versioni successive

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

getRecentlyClosed()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (sessions: Session[]) => void

    • sessioni

      Session[]

      L'elenco delle voci chiuse nell'ordine inverso rispetto a quello in cui sono state chiuse (la scheda o la finestra chiusa più di recente si troverà nell'indice 0). Le voci possono contenere schede o finestre.

Resi

  • Promise<Session[]>

    Chrome 96 e versioni successive

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

restore()

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

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

Parametri

Resi

  • Promise<Session>

    Chrome 96 e versioni successive

    Le promise 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,
)

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

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void