From 45cd866b9dac17aa2a0b834dfab54e501a77c8b6 Mon Sep 17 00:00:00 2001
From: Муравьёв Семён <s01@ngs.ru>
Date: Fri, 11 Feb 2022 22:20:29 +0300
Subject: RU: Storage.key add null return case and specs (#4055)

* RU: Storage.key add null return case and specs

* Update and rename index.html to index.md

Co-authored-by: Alexey Pyltsyn <lex61rus@gmail.com>
---
 files/ru/web/api/storage/key/index.html | 68 ---------------------------------
 files/ru/web/api/storage/key/index.md   | 63 ++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 68 deletions(-)
 delete mode 100644 files/ru/web/api/storage/key/index.html
 create mode 100644 files/ru/web/api/storage/key/index.md

diff --git a/files/ru/web/api/storage/key/index.html b/files/ru/web/api/storage/key/index.html
deleted file mode 100644
index d9df91e329..0000000000
--- a/files/ru/web/api/storage/key/index.html
+++ /dev/null
@@ -1,68 +0,0 @@
----
-title: Storage.key()
-slug: Web/API/Storage/key
-tags:
-  - API
-  - Storage
-  - Web Storage
-  - Справка
-  - Хранилище
-translation_of: Web/API/Storage/key
----
-<p>{{APIRef()}}</p>
-
-<p>Метод key() интерфейса {{domxref("Storage")}} получает числовое значение n и возвращает имя n-ого ключа из хранилища.  Порядок ключей определяется браузером.</p>
-
-<h2 id="Синтаксис">Синтаксис</h2>
-
-<pre class="syntaxbox">var <em>aKeyName</em> = <em>storage</em>.key(<em>key</em>);</pre>
-
-<h3 id="Параметры">Параметры</h3>
-
-<dl>
- <dt><em>Ключ</em></dt>
- <dd>Целое нумерованное значение представляющее номер ключа, которого Вы хотите получить. Индексация начинается с нуля. </dd>
-</dl>
-
-<h3 id="Возвращает">Возвращает</h3>
-
-<p>{{domxref("DOMString")}} , содержащий имя ключа.</p>
-
-<h2 id="Пример">Пример</h2>
-
-<p>Следующая функция перебирает все ключи из хранилища.</p>
-
-<pre class="brush: js">function forEachKey(callback) {
-  for (var i = 0; i &lt; localStorage.length; i++) {
-    callback(localStorage.key(i));
-  }
-}</pre>
-
-<div class="note">
-<p><strong>Примечание</strong>: Реальный пример вы можете увидеть на <a href="https://github.com/mdn/web-storage-demo">Web Storage Demo</a>.</p>
-</div>
-
-<h2 id="Стандарты">Стандарты</h2>
-
-<table class="standard-table">
- <tbody>
-  <tr>
-   <th scope="col">Стандарт</th>
-   <th scope="col">Статус</th>
-   <th scope="col">Комментарий</th>
-  </tr>
-  <tr>
-   <td>{{SpecName('Web Storage', '#dom-storage-key', 'key()')}}</td>
-   <td>{{Spec2('Web Storage')}}</td>
-   <td> </td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>
-
-<p>{{Compat}}</p>
-
-<h2 id="Смотрите_также">Смотрите также</h2>
-
-<p><a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a></p>
diff --git a/files/ru/web/api/storage/key/index.md b/files/ru/web/api/storage/key/index.md
new file mode 100644
index 0000000000..1488f5799d
--- /dev/null
+++ b/files/ru/web/api/storage/key/index.md
@@ -0,0 +1,63 @@
+---
+title: Storage.key()
+slug: Web/API/Storage/key
+tags:
+  - API
+  - Method
+  - Reference
+  - Storage
+  - Web Storage
+browser-compat: api.Storage.key
+---
+{{APIRef("Web Storage API")}}
+
+Метод **`key()`** интерфейса {{domxref("Storage")}} получает числовое значение n и возвращает имя n-ого ключа из данного объекта `Storage`. Порядок ключей зависит от реализации браузера, поэтому лучше не полагаться на него.
+
+## Syntax
+
+```js
+var aKeyName = storage.key(index);
+```
+
+### Параметры
+
+- `index`
+  - : Целочисленное значение, представляющее номер ключа, имя которого нужно получить. Индексация начинается с нуля. 
+
+### Возвращаемое значение
+
+{{domxref("DOMString")}} с именем ключа. Если этот индекс не найден, вернётся `null`.
+
+## Примеры
+
+Следующая функция перебирает все ключи из локального хранилища:
+
+```js
+function forEachKey(callback) {
+  for (var i = 0; i < localStorage.length; i++) {
+    callback(localStorage.key(i));
+  }
+}
+```
+
+Следующая функция перебирает все ключи из локального хранилища и получает значение по каждому из них:
+
+```js
+for (var i = 0; i < localStorage.length; i++) {
+  console.log(localStorage.getItem(localStorage.key(i)));
+}
+```
+
+> **Примечание:** более реалистичный пример использования функции показан на странице [Web Storage Demo](https://mdn.github.io/dom-examples/web-storage/).
+
+## Спецификации
+
+{{Specifications}}
+
+## Поддержка браузерами
+
+{{Compat}}
+
+## Смотрите также
+
+- [Использование Web Storage API](/ru/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API)
-- 
cgit v1.2.3-54-g00ecf