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

    Un elenco di sessioni delle 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

    Tab facoltativo

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

  • finestra

    Finestra facoltativa

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

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

Recupera tutti i dispositivi con sessioni sincronizzate.

Parametri

  • filtro

    Filtro facoltativo

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto:

    (devices: Device[]) => void

    • dispositivi

      L'elenco di oggetti sessions.Device per ogni sessione sincronizzata, ordinato 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 all'anzianità nel campo windows.Window degli oggetti sessions.Session.

Resi

  • Promise<Device[]>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getRecentlyClosed()

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

Recupera l'elenco delle schede e/o finestre chiuse di recente.

Parametri

  • filtro

    Filtro facoltativo

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto:

    (sessions: Session[]) => void

    • sessioni

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

Resi

  • Promise<Session[]>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

restore()

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

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 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

Eventi

onChanged

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

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

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto:

    () => void