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.

À voir également

Utilisation de l'API de stockage web

Étiquettes et contributeurs liés au document

Contributeurs à cette page : JNa0, Axnyff
Dernière mise à jour par : JNa0,