La propriété en lecture seule de l'interface Storage retourne un entier représentant le nombre d'items stockés dans l'objet Storage.
Syntaxe
var aLength = storage.length;
Retour
Un entier.
Exemple
La fonction suivante ajoute trois éléments au localStorage du domaine courant puis retourne le nombre d'éléments dans le storage:
function populateStorage() {
localStorage.setItem('bgcolor', 'yellow');
localStorage.setItem('font', 'Helvetica');
localStorage.setItem('image', 'cats.png');
localStorage.length; // retourne 3 si localStorage est vide au préalable
}
Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| HTML Living Standard La définition de 'Storage.length' dans cette spécification. |
Standard évolutif |
Compatibilité
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
| Fonctionnalité | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Support de base | 2.1 | ? | 8 | 11 | iOS 3.2 |
Tous les navigateurs ont des niveaux de capacité de stockage variables, que ce soit pour localStorage ou sessionStorage. Pour un test de l'ensemble des capacités des différents navigateurs voir ici.
Note : Depuis iOS 5.1, Safari Mobile stocke les données liées à localStorage dans un fichier de cache qui est sujet à un nettoyage occasionnel par ordre du système d'exploitation, surtout lorsqu'il reste peu de place.