chrome.sessions

refresh date: 2026-09-25 robots: noindex

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

Promise

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

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

Paramètres

• filtre

  Filtre (facultatif)

• callback

  function facultatif

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

  (devices: Device[]) => void

  • appareils

    Device[]

    Liste des objets sessions.Device pour chaque session synchronisée, triés par ordre de modification de la session (de la plus récente à la plus ancienne). Les objets tabs.Tab sont triés par récence dans le champ windows.Window des objets sessions.Session.

Renvoie

• Promise<Device[]>

  Chrome 96 ou version ultérieure

  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[]>

Récupère 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é(e) le plus récemment 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 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

• sessionId

  chaîne facultatif

  windows.Window.sessionId ou tabs.Tab.sessionId à restaurer. Si ce paramètre n'est pas spécifié, la session fermée la plus récemment est restaurée.

• callback

  function facultatif

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

  (restoredSession: Session) => void

  • restoredSession

    Session

    Un sessions.Session contenant l'objet windows.Window ou tabs.Tab restauré.

Renvoie

• Promise<Session>

  Chrome 96 ou version ultérieure

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

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