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 straniero.

• sessioni

  Sessione[]

  Un elenco di sessioni di finestra aperta per il dispositivo straniero, ordinate dalla sessione modificata più di recente a quella meno 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 momento in cui la finestra o la scheda è stata chiusa o modificata, espressa in millisecondi dall'epoca.

• Home

  Scheda facoltativa

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

• finestra

  Finestra facoltativa

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

Proprietà

MAX_SESSION_RESULTS

Il numero massimo di sessions.Session che sarà incluso in un elenco richiesto.

Valore

25

Metodi

getDevices()

Promessa

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

Recupera tutti i dispositivi con sessioni sincronizzate.

Parametri

• filter

  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 dal dispositivo con la sessione modificata più di recente al dispositivo con la sessione modificata meno di recente. tabs.Tab oggetti sono ordinati per recency nella sezione windows.Window di sessions.Session oggetti.

Ritorni

• Promessa<Dispositivo[]>

  Chrome 96 e versioni successive

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

getRecentlyClosed()

Promessa

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

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

Parametri

• filter

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

Ritorni

• Promessa<Sessione[]>

  Chrome 96 e versioni successive

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

restore()

Promessa

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

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

Parametri

• sessionId

  stringa facoltativo

  windows.Window.sessionId o tabs.Tab.sessionId da ripristinare. Se questo parametro non viene specificato, viene ripristinata l'ultima sessione chiusa.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  (restoredSession: Session)=>void

  • restoredSession

    Sessione

    Una sessions.Session contenente l'oggetto windows.Window o tabs.Tab ripristinato.

Ritorni

• Promessa<Sessione>

  Chrome 96 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al 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