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 sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

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 sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.

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 sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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é 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