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é
Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !
| 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.