chrome.sessions

Description

Utilisez l'API chrome.sessions pour interroger et restaurer les onglets et les fenêtres d'une session de navigation.

Autorisations

sessions

Types

Device

Propriétés

  • deviceName

    chaîne

    Nom de l'appareil étranger.

  • sessions

    Session[]

    Liste des sessions de fenêtres ouvertes pour l'appareil étranger, triées de la session la plus récemment modifiée à la moins récemment modifiée.

Filter

Propriétés

  • maxResults

    number facultatif

    Nombre maximal d'entrées à récupérer dans la liste demandée. Omettez ce paramètre pour récupérer le nombre maximal d'entrées (sessions.MAX_SESSION_RESULTS).

Session

Propriétés

  • lastModified

    Total

    Heure à laquelle la fenêtre ou l'onglet a été fermé ou modifié, représentée en secondes depuis l'epoch.

  • tabulation

    Onglet facultatif

    tabs.Tab, si cette entrée décrit un onglet. Cette valeur ou sessions.Session.window sera définie.

  • fenêtre

    Fenêtre facultatif

    windows.Window, si cette entrée décrit une fenêtre. Cette valeur ou sessions.Session.tab sera définie.

Propriétés

MAX_SESSION_RESULTS

Nombre maximal de sessions.Session qui seront inclus dans une liste demandée.

Valeur

25

Méthodes

getDevices()

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

Récupère tous les appareils dont les sessions sont synchronisées.

Paramètres

  • filtre

    Filtre facultatif

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (devices: Device[]) => void

    • appareils

      Appareil[]

      Liste des objets sessions.Device pour chaque session synchronisée, triée de l'appareil dont la session a été modifiée le plus récemment à celui dont la session a été modifiée le moins récemment. Les objets tabs.Tab sont triés par ancienneté dans windows.Window des objets sessions.Session.

Renvoie

  • Promise<Device[]>

    Chrome 96 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getRecentlyClosed()

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

Obtient la liste des onglets et/ou fenêtres récemment fermés.

Paramètres

  • filtre

    Filtre facultatif

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (sessions: Session[]) => void

    • sessions

      Session[]

      Liste des entrées fermées dans l'ordre inverse de leur fermeture (l'onglet ou la fenêtre fermés le plus récemment se trouveront à l'index 0). Les entrées peuvent contenir des onglets ou des fenêtres.

Renvoie

  • Promise<Session[]>

    Chrome 96 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

restore()

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

Rouvre un windows.Window ou un tabs.Tab, avec un rappel facultatif à exécuter lorsque l'entrée a été restaurée.

Paramètres

Renvoie

  • Promise<Session>

    Chrome 96 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onChanged

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

Événement déclenché lorsque des onglets et/ou fenêtres récemment fermés sont modifiés. Cet événement ne surveille pas les modifications apportées aux sessions synchronisées.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    () => void