chrome.sessions

Description

Utilisez l'API chrome.sessions pour interroger et restaurer des onglets et des 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 à fenêtre ouverte pour 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 à 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 a été fermé ou modifié, représenté en millisecondes depuis l'epoch.

• tabulation

  Tabulation facultatif

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

• fenêtre

  Fenêtre facultatif

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

Valeur

25

Méthodes

getDevices()

<ph type="x-smartling-placeholder"></ph> 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

  function facultatif

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

  (devices: Device[]) => void

  • appareils

    Appareil[]

    Liste des objets sessions.Device pour chaque session synchronisée, triés du plus récent au plus ancien. Les objets tabs.Tab sont triés par ordre chronologique dans le windows.Window des objets sessions.Session.

Renvoie

• Promesse<Appareil[]>

  Chrome 96 ou version ultérieure

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

getRecentlyClosed()

<ph type="x-smartling-placeholder"></ph> Promesse

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

Permet d'obtenir la liste des onglets et/ou des fenêtres récemment fermés.

Paramètres

• filtre

  Filtre facultatif

• rappel

  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 selon lequel elles ont été fermées (l'onglet ou la fenêtre fermés le plus récemment correspond à l'index 0). Les entrées peuvent contenir des onglets ou des fenêtres.

Renvoie

• Promesse<Session[]>

  Chrome 96 ou version ultérieure

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

restore()

<ph type="x-smartling-placeholder"></ph> 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

  chaîne 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

  function facultatif

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

  (restoredSession: Session) => void

  • restoredSession

    Session

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

Renvoie

• Promise&lt;Session&gt;

  Chrome 96 ou version ultérieure

  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é lors de la modification d'un onglet ou d'une fenêtre récemment fermés Cet événement ne surveille pas les modifications apportées aux sessions synchronisées.

Paramètres

• rappel

  fonction

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

  () => void