Cette page a été traduite par l'API Cloud Translation.

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

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<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.

É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
```