Метод key() интерфейса Storage получает числовое значение n и возвращает имя n-ого ключа из хранилища. Порядок ключей определяется браузером.
Синтаксис
var aKeyName = storage.key(key);
Параметры
- Ключ
- Целое нумерованное значение представляющее номер ключа, которого Вы хотите получить. Индексация начинается с нуля.
Возвращает
DOMString , содержащий имя ключа.
Пример
Следующая функция перебирает все ключи из хранилища.
function forEachKey(callback) {
for (var i = 0; i < localStorage.length; i++) {
callback(localStorage.key(i));
}
}
Примечание: Реальный пример Вы можете увидеть на Web Storage Demo.
Стандарты
| Стандарт | Статус | Комментарий |
|---|---|---|
| Web Storage (Second edition) Определение 'key()' в этой спецификации. |
Рекомендация |
Совместимость с браузерами
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| localStorage | 4 | 3.5 | 8 | 10.50 | 4 |
| sessionStorage | 5 | 2 | 8 | 10.50 | 4 |
| Feature | 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, обычно это происходит, когда мало доступного места.