Свойство localStorage позволяет получить доступ к локальному Storage объекту. localStorage аналогичено свойству sessionStorage. Разница только в том, свойство sessionStorage хранит данные в течение сеанса (до закрытия браузера), в отличие от данных, находящихся в свойстве localStorage, которые не имеют ограничений по времени хранения и могут быть удалены только с помощью JavaScript.
Синтаксис
myStorage = localStorage;
Значение
Объект Storage.
Пример
Следующий код показывает пример доступа к локальному объекту Storage для текущего домена и добавляет данные в него с помощью Storage.setItem().
localStorage.setItem('myCat', 'Tom');
Примечание: Пожалуйста, обратитесь к статье Using the Web Storage API для более подробных примеров.
Спецификации
| Спецификация | Статус | Коментарий |
|---|---|---|
| Web Storage (Second edition) Определение 'localStorage' в этой спецификации. |
Рекомендация |
Поддержка браузерами
| Характеристика | 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 в папке cache, которая периодически подлежит очистке по требованию ОС, как правило при недостаточном количестве свободного места. Режим инкогнито в Safari Mobile также полностью предотвращает запись в localStorage.