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 a finestre aperte per il dispositivo esterno, ordinate dalla sessione modificata più di recente a quella modificata meno di 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 tempo in cui la finestra o la scheda è stata chiusa o modificata, rappresentata in millisecondi dall'epoca.

• tab

  Scheda facoltativa

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

• finestra

  Finestra facoltativa

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

Promesso .

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

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 di oggetti sessions.Device per ogni sessione sincronizzata, ordinati in base al 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 nell'elemento windows.Window degli oggetti sessions.Session.

Resi

• Prometti <dispositivo[]>

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

Promesso .

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

Consente di recuperare l'elenco di schede e/o 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 di voci chiuse in ordine inverso rispetto alla chiusura (la scheda o la finestra chiusa più di recente sarà all'indice 0). Le voci possono contenere schede o finestre.

Resi

• Promessa<sessione[]>

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

Promesso .

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

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

Parametri

• sessionId

  stringa facoltativo

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

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  (restoredSession: Session) => void

  • restoredSession

    Sessione

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

Resi

• Promise&lt;Session&gt;

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

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