--- title: Storage.key() slug: Web/API/Storage/key tags: - API - Storage - Web Storage - Справка - Хранилище translation_of: Web/API/Storage/key ---

{{APIRef()}}

Метод key() интерфейса {{domxref("Storage")}} получает числовое значение n и возвращает имя n-ого ключа из хранилища.  Порядок ключей определяется браузером.

Синтаксис

var aKeyName = storage.key(key);

Параметры

Ключ
Целое нумерованное значение представляющее номер ключа, которого Вы хотите получить. Индексация начинается с нуля. 

Возвращает

{{domxref("DOMString")}} , содержащий имя ключа.

Пример

Следующая функция перебирает все ключи из хранилища.

function forEachKey(callback) {
  for (var i = 0; i < localStorage.length; i++) {
    callback(localStorage.key(i));
  }
}

Примечание: Реальный пример Вы можете увидеть на Web Storage Demo.

Стандарты

Стандарт Статус Комментарий
{{SpecName('Web Storage', '#dom-storage-key', 'key()')}} {{Spec2('Web Storage')}}  

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

{{ CompatibilityTable() }}

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 {{ CompatUnknown }} 8 11 iOS 3.2

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

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

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

Using the Web Storage API