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

  • sessions

    Session[]

    Liste des sessions de fenêtres ouvertes pour l'appareil externe, 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

    nombre

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

  • tabulation

    Tab facultatif

    tabs.Tab, si cette entrée décrit un onglet. Ce champ ou sessions.Session.window sera défini.

  • fenêtre

    Window facultatif

    windows.Window, si cette entrée décrit une fenêtre. Ce champ ou sessions.Session.tab sera défini.

Propriétés

MAX_SESSION_RESULTS

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

Valeur

25

Méthodes

getDevices()

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

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

Paramètres

Renvoie

  • Promise<Device[]>

    Chrome 96+ browser.* depuis Chrome 148

getRecentlyClosed()

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

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

Paramètres

Renvoie

  • Promise<Session[]>

    Chrome 96+ browser.* depuis Chrome 148

restore()

browser.sessions.restore(
  sessionId?: string,
): 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+ browser.* depuis Chrome 148

Événements

onChanged

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

Déclenché lorsque les 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