Russian-translate for for...of.md

Author: irivanych

docs/for...of.md

@@ -1,5 +1,5 @@
 ### for...of
-A common error experienced by beginning JavaScript developers is that `for...in` for an array does not iterate over the array items. Instead it iterates over the *keys* of the object passed in. This is demonstrated in the below example. Here you would expect `9,2,5` but you get the indexes `0,1,2`:
+Распространенная ошибка, с которой сталкиваются начинающие JavaScript разработчики - это то, что `for...in` для массива не итерирует элементы массива. Вместо этого итерация происходит по *ключам* переданного объекта. Это показано на примере ниже. Здесь мы ожидаем `9,2,5`, но получаем индексы `0,1,2`:
 
 ```ts
 var someArray = [9, 2, 5];
@@ -8,7 +8,7 @@ for (var item in someArray) {
 }
 ```
 
-This is one of the reasons why `for...of` exists in TypeScript (and ES6). The following iterates over the array correctly logging out the members as expected:
+Это первая причина, по которой `for...of` существует в TypeScript (и ES6). Следующая итерация массива корректно выводит члены массива как ожидалось:
 
 ```ts
 var someArray = [9, 2, 5];
@@ -17,7 +17,7 @@ for (var item of someArray) {
 }
 ```
 
-Similarly TypeScript has no trouble going through a string character by character using `for...of`:
+Точно также TypeScript  не испытывает затруднений при итерировании строки посимвольно, используя `for...of`:
 
 ```ts
 var hello = "is it me you're looking for?";
@@ -26,36 +26,37 @@ for (var char of hello) {
 }
 ```
 
-#### JS Generation
-For pre ES6 targets TypeScript will generate the standard `for (var i = 0; i < list.length; i++)` kind of loop. For example here's what gets generated for our previous example:
+#### Генерация JS
+Для версий JS до ES6 TypeScript генерирует стандартный тип цикла `for (var i = 0; i < list.length; i++)`. Например, вот что генерируется для нашего предыдущего примера:
+
 ```ts
 var someArray = [9, 2, 5];
 for (var item of someArray) {
     console.log(item);
 }
 
-// becomes //
+// становится //
 
 for (var _i = 0; _i < someArray.length; _i++) {
     var item = someArray[_i];
     console.log(item);
 }
 ```
-You can see that using `for...of` makes *intent* clearer and also decreases the amount of code you have to write (and variable names you need to come up with).
+Вы видите, что использование `for...of` делает код более понятным и уменьшает его объем.
 
-#### Limitations
-If you are not targeting ES6 or above, the generated code assumes the property `length` exists on the object and that the object can be indexed via numbers e.g. `obj[2]`. So it is only supported on `string` and `array` for these legacy JS engines.
+#### Ограничения
+Для версий JS до ES6, сгенерированный код предполагает, что свойство `length` существует на объекте и этот объект может быть проиндексирован по номерам, например `obj[2]`. Это поддерживается только для строк и массивов для устаревших движков JS.
 
-If TypeScript can see that you are not using an array or a string it will give you a clear error *"is not an array type or a string type"*;
+Если вы используете `for...of` не на массиве или строке, TypeScript сообщит об это ошибкой *"is not an array type or a string type"*.
 ```ts
 let articleParagraphs = document.querySelectorAll("article > p");
-// Error: Nodelist is not an array type or a string type
+// Ошибка: Nodelist is not an array type or a string type
 for (let paragraph of articleParagraphs) {
     paragraph.classList.add("read");
 }
 ```
 
-Use `for...of` only for stuff that *you know* to be an array or a string. Note that this limitation might be removed in a future version of TypeScript.
+Используйте `for...of` только для случаев, когда *вы уверены*, что применяете это к строке или массиву. Помните, что это ограничение может быть удалено на следующих версиях TypeScript.
 
-#### Summary
-You would be surprised at how many times you will be iterating over the elements of an array. The next time you find yourself doing that, give `for...of` a go. You might just make the next person who reviews your code happy.
+#### Заключение
+Вы можете удивиться, как часто вы итерируете элементы массива. В следующий раз, когда будете это делать, попробуйте использовать `for...of`. Вы можете просто порадовать следующего человека, который просматривает ваш код.