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 ouvertes sur l'appareil étranger, triées de la session la plus récente à la moins récemment modifiée.

Filter

Propriétés

  • maxResults

    numéro facultatif

    Nombre maximal d'entrées à extraire 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

    number

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

  • tab

    Tabulation facultatif

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

  • fenêtre

    Window (Fenêtre) facultatif

    La valeur 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 à inclure dans une liste demandée.

Valeur

25

Méthodes

getDevices()

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

Récupère tous les appareils avec des sessions synchronisées.

Paramètres

  • filtre

    Filtre facultatif

  • rappel

    fonction facultative

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

    (devices: Device[])=>void

Renvoie

  • Promesse<Appareil[]>

    Chrome 96 et versions ultérieures

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

getRecentlyClosed()

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

Récupère la liste des onglets et/ou fenêtres récemment fermés.

Paramètres

  • filtre

    Filtre facultatif

  • rappel

    fonction facultative

    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 les plus récemment fermés seront associés à l'index 0). Les entrées peuvent contenir soit des onglets, soit des fenêtres.

Renvoie

  • Promesse<Session[]>

    Chrome 96 et versions ultérieures

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

restore()

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

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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onChanged

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

Déclenché lorsque des onglets et/ou des 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

  • rappel

    function

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

    ()=>void