blob: 3566b219f2df89b9bca0ccd77adf74a2e26522b5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
---
title: sessions.forgetClosedTab()
slug: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab
tags:
- API
- Add-ons
- Extensions
- Method
- Reference
- WebExtensions
- forgetClosedTab
- sessions
translation_of: Mozilla/Add-ons/WebExtensions/API/sessions/forgetClosedTab
---
{{AddonSidebar()}}Supprime un onglet fermé de la liste des onglets récemment fermés du navigateur.Notez que les sites visités par cet onglet ne sont pas supprimés de l'historique du navigateur. Utilisez les API {{WebExtAPIRef("browsingData")}} oo {{WebExtAPIRef("history")}} pour supprimer l'historique.
C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise).
## Syntaxe
```js
var forgettingTab = browser.sessions.forgetClosedTab(
windowId, // integer
sessionId // string
)
```
### Paramètres
- `windowId`
- : `Integer`. L'ID de la fenêtre qui héberge l'onglet que vous voulez oublier.
- `sessionId`
- : `String`. L'identifiant de la session que vous voulez oublier.
### Valeur retournée
Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Cela sera accompli sans arguments lorsque la session a été supprimée.
Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.
## Compatibilité du navigateur
{{Compat("webextensions.api.sessions.forgetClosedTab")}}
## Exemples
Ce code oublie la dernière session fermée, qu'il s'agisse d'un onglet ou d'une fenêtre :
```js
function forgetMostRecent(sessionInfos) {
if (!sessionInfos.length) {
console.log("No sessions found")
return;
}
let sessionInfo = sessionInfos[0];
if (sessionInfo.tab) {
browser.sessions.forgetClosedTab(sessionInfo.tab.windowId, sessionInfo.tab.sessionId);
} else {
browser.sessions.forgetClosedWindow(sessionInfo.window.sessionId);
}
}
function onError(error) {
console.log(error);
}
browser.sessions.getRecentlyClosed({maxResults: 1})
.then(forgetMostRecent, onError);
```
{{WebExtExamples}}
|
