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
|
---
title: StorageManager.estimate()
slug: Web/API/StorageManager/estimate
translation_of: Web/API/StorageManager/estimate
---
{{securecontext_header}}{{APIRef("Storage")}}
La méthode **`estimate()`** de l’interface {{domxref("StorageManager")}} demande au gestionnaire de stockage d’obtenir des informations de quota et d’usage pour l’origine actuelle. Cette méthode opère de manière asynchrone, elle renvoie donc une {{jsxref("Promise")}} qui se résoud une fois que l’information est disponible. La fonction gérant la résolution de la promesse reçoit en entrée un {{domxref("StorageEstimate")}} avec les données de quota et d’usage.
## Syntaxe
var estimatePromise = StorageManager.estimate();
### Paramètres
Aucun.
### Valeur de retour
Une {{jsxref('Promise')}} qui se résoud en un objet qui se conforme au dictionnaire {{domxref('StorageEstimate')}}. Ce dictionnaire contient des estimations de la quantité d’espace disponible à l’origine ou à l’application (dans {{domxref("StorageEstimate.quota")}}), ainsi que la quantité d’espace actuellement utilisé (dans {{domxref("StorageEstimate.usage")}}). Ces nombres ne sont pas exacts ; entre la compression, la dé-duplication, et l’obfuscation pour des raisons de sécurité, ils ne seront pas précis.
Il est possible de constater que le `quota` varie d’application en application, basé sur des facteurs tels que la fréquence à laquelle l’utilisateur ou l’utilisatrice la visite, des données de popularité de sites bien connus, et ainsi de suite.
## Exemple
Dans cet exemple, nous obtenons des estimations d’usage et présentons le pourcentage de capacité de stockage actuellement utilisé à l’utilisateur ou à l’utilisatrice.
### Contenu HTML
```html
<p>
Vous utilisez actuellement environ <span id="percent">
</span>% de votre espace disponible.
</p>
```
### Contenu JavaScript
```js
navigator.storage.estimate().then(function(estimate) {
document.getElementById("percent").textContent =
(estimate.usage / estimate.quota).toFixed(2);
});
```
### Résultat
{{ EmbedLiveSample('Exemple', 600, 40) }}
## Spécifications
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------------------- | ---------------------------- | -------------------- |
| {{SpecName('Storage','#dom-storagemanager-estimate','estimate()')}} | {{Spec2('Storage')}} | Définition initiale. |
## Compatibilité des navigateurs
{{Compat("api.StorageManager.estimate")}}
## Voir aussi
- l’API Storage
- {{domxref("Storage")}}, l’objet renvoyé par {{domxref("Window.localStorage")}}
- {{domxref("StorageManager")}}
- {{domxref("navigator.storage")}}
|