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

  • appareils

    Appareil[]

    Liste d'objets sessions.Device pour chaque session synchronisée, triés de l'appareil avec la dernière session modifiée à l'appareil avec la session la moins récemment modifiée. Les objets tabs.Tab sont triés par date dans la windows.Window des objets sessions.Session.

Renvoie

• Promesse<Appareil[]>

  Chrome 96 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 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 est résolue 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 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 sont compatibles avec Manifest V3 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 est résolue avec le même type que celui transmis au rappel.

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

• sessionId

  string facultatif

  Le windows.Window.sessionId ou le tabs.Tab.sessionId à restaurer. Si ce paramètre n'est pas spécifié, la dernière session fermée est restaurée.

• rappel

  fonction facultative

  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 et versions ultérieures

  Les promesses sont compatibles avec Manifest V3 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 est résolue avec le même type que celui transmis au rappel.

É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