Storage.length

Свойство length интерфейса Storage доступно только для чтения и возвращает число с количеством элементов, которые хранятся в объекте Storage на данный момент.

Синтаксис

var aLength = storage.length;

Возвращаемые значения

Число

Пример

Следующая функция добавляет три элемента с данными в локальное хранилище для домена, на котором выполняется код и возвращает число элементов в хранилище:

function populateStorage() {
  localStorage.setItem('bgcolor', 'yellow');
  localStorage.setItem('font', 'Helvetica');
  localStorage.setItem('image', 'cats.png');

  localStorage.length; // return 3
}

Примечание: чтобы посмотреть выполнение кода вживую, посетите страницу Web Storage Demo.

Спецификации

Спецификация Статус Комментарий
Unknown
Определение 'length' в этой спецификации.
Неизвестно  

Совместимость с браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Характеристика Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Характеристика Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 ? 8 11 iOS 3.2

Все браузеры имеют различный уровень объёма для localStorage и sessionStorage. Здесь подробное описание объёма хранилищ для разных браузеров.

Примечание: начиная с версии iOS 5.1, Safari Mobile хранит данные localStorage в папке с кешем, которая может быть очищена случайно по требованию OS, обычно это происходит, когда мало доступного места.

Смотрите также

Использование Web Storage API