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

    Liste des sessions de fenêtre ouvertes pour l'appareil externe, triées de la session la plus récente à la moins récente.

Filter

Propriétés

  • maxResults

    number facultatif

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

Session

Propriétés

  • lastModified

    Total

    Heure à laquelle la fenêtre ou l'onglet ont été fermés ou modifiés, exprimé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()

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

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

Paramètres

  • filtre

    Filtre facultatif

  • callback

    fonction facultatif

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

    (devices: Device[]) => void

    • appareils

      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 ordre de récence dans le windows.Window des objets sessions.Session.

Renvoie

  • Promise<Device[]>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getRecentlyClosed()

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

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

Paramètres

  • filtre

    Filtre facultatif

  • callback

    fonction facultatif

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

    (sessions: Session[]) => void

    • sessions

      Liste des entrées fermées dans l'ordre inverse de leur fermeture (l'onglet ou la fenêtre fermée en dernier se trouve à l'index 0). Les entrées peuvent contenir des onglets ou des fenêtres.

Renvoie

  • Promise<Session[]>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

restore()

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

Réouvre un windows.Window ou tabs.Tab, avec un rappel facultatif à exécuter une fois l'entrée restaurée.

Paramètres

Renvoie

  • Promise<Session>

    Chrome 96 ou version ultérieure

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

Événements

onChanged

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

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