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

  Session[]

  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

    Dispositivo[]

    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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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

    Session[]

    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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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

• sessionId

  stringa facoltativa

  windows.Window.sessionId o tabs.Tab.sessionId da ripristinare. Se questo parametro non è specificato, viene ripristinata la sessione chiusa più di recente.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (restoredSession: Session) => void

  • restoredSession

    Sessione

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

Resi

• Promise<Session>

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

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