renovations

1-js/4-data-structures/9-array-iteration/article.md

@@ -8,9 +8,9 @@
 
 Метод ["arr.forEach(callback[, thisArg])"](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/forEach) используется для перебора массива.
 
-Он позволяет перебрать массив при помощи функции `callback`, что зачастую гораздо элегантнее, нежели цикл `for`.
+Он позволяет для каждого элемента массива вызывает функцию `callback`. 
 
-Функция `callback` вызывается для каждого элемента с тремя параметрами `callback(item, i, arr)`:
+Этой функции он передаёт три параметра `callback(item, i, arr)`:
 
 <ul>
 <li>`item` -- очередной элемент массива.</li>
@@ -24,16 +24,14 @@
 //+ run
 var arr = ["Яблоко", "Апельсин", "Груша"];
 
-function show(item, i, arr) {
+arr.forEach(function(item, i, arr) {
   alert(i + ": " + item + " (массив:" + arr + ")");
-}
-
-arr.forEach(show);
+});
 ```
 
 Второй, необязательный аргумент `forEach` позволяет указать контекст `this` для `callback`. Мы обсудим его в деталях чуть позже, сейчас он нам не важен.
 
-Метод `forEach` ничего не возвращает, его используют только для перебора.
+Метод `forEach` ничего не возвращает, его используют только для перебора, как более "элегантный" вариант, чем обычный цикл `for`.
 
 ## filter
 
@@ -47,12 +45,10 @@ arr.forEach(show);
 //+ run
 var arr = [1, -1, 2, -2, 3];
 
-function isPositive(number) {
-  return number > 0;
-}
-
 *!*
-var positiveArr = arr.filter(isPositive);
+var positiveArr = arr.filter(function(number) {
+  return number > 0;
+});
 */!*
 
 alert(positiveArr); // 1,2,3
@@ -68,27 +64,26 @@ alert(positiveArr); // 1,2,3
 
 ```js
 //+ run
-var arr = [1, 2, 3, 4];
-
-function square(number) {
-  return number * number;
-}
+var pages = ['a.html', 'b.html', 'c.html'];
 
 *!*
-var squaredArr = arr.map(square);
+var urls = pages.map(function(page) {
+  return 'http://site.com/' + page;
+});
 */!*
 
-alert(squaredArr); // получили массив квадратов чисел: 1, 4, 9, 16
+// к каждой строке был прибавлен префикс
+alert(urls); // http://site.com/a.html, http://site.com/b.html...
 ```
 
 ## every/some
 
 Эти методы используется для проверки массива.
 
-Метод ["arr.every(callback[, thisArg])"](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/every) возвращает `true`, если вызов `callback` вернёт `true` для *каждого* элемента `arr`.
-
- 
-Метод ["arr.some(callback[, thisArg])"](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/some) возвращает `true`, если вызов `callback` вернёт `true` для *какого-нибудь* элемента `arr`.
+<ul>
+<li>Метод ["arr.every(callback[, thisArg])"](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/every) возвращает `true`, если вызов `callback` вернёт `true` для *каждого* элемента `arr`.</li>
+<li>Метод ["arr.some(callback[, thisArg])"](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/some) возвращает `true`, если вызов `callback` вернёт `true` для *какого-нибудь* элемента `arr`.</li>
+</ul>
 
 ```js
 //+ run
@@ -117,15 +112,17 @@ alert( arr.some(isPositive) ); // true, есть хоть одно положи
 Аргументы функции `callback(previousValue, currentItem, index, arr)`:
 
 <ul>
-<li>`previousValue` -- последний результат вызова функции, он же "промежуточный результат". Значение `previousValue` при первом вызове равно `initialValue` (второй аргумент `reduce`) или, если у `reduce` нет второго аргумента, то оно равно первому элементу массива, а перебор начинается со второго.</li>
+<li>`previousValue` -- последний результат вызова функции, он же "промежуточный результат".</li>
 <li>`currentItem` -- текущий элемент массива, элементы перебираются по очереди слева-направо. </li>
 <li>`index` -- номер текущего элемента.</li>
 <li>`arr` -- обрабатываемый массив.</li>
 </ul>
 
-Разберём работу метода `reduce` на примере. 
+Кроме `callback`, методу можно передать "начальное значение" -- аргумент `initialValue`. Если он есть, то на первом вызове значение `previousValue` будет равно `initialValue`, а если у `reduce` нет второго аргумента, то оно равно первому элементу массива, а перебор начинается со второго.
 
-Пусть мы хотим вычислить сумму всех элементов массива. Можно сделать это при помощи цикла, но это как раз подходящий повод познакомиться с `reduce`.
+Проще всего понять работу метода `reduce` на примере. 
+
+Например, в качестве "свёртки" мы хотим получить сумму всех элементов массива. 
 
 Вот решение в одну строку:
 
@@ -133,23 +130,30 @@ alert( arr.some(isPositive) ); // true, есть хоть одно положи
 //+ run
 var arr = [1, 2, 3, 4, 5]
 
-var result = arr.reduce(function(prev, current) { return prev + current }, 0);
+// для каждого элемента массива запустить функцию, 
+// промежуточный результат передавать первым аргументом далее
+var result = arr.reduce(function(sum, current) { return sum + current; }, 0);
 
 alert(result); // 15
 ```
 
 Разберём, что в нём происходит.
 
-Здесь начальное значение, с которого начинаются вычисления, равно нулю (второй аргумент `reduce`).
+При первом запуске `sum` -- исходное значение, с которого начинаются вычисления, равно нулю (второй аргумент `reduce`).
 
 Сначала анонимная функция вызывается с этим начальным значением и первым элементом массива, результат запоминается и передаётся в следующий вызов, уже со вторым аргументом массива, затем новое значение участвует в вычислениях с третьим аргументом и так далее.
 
-Таблица вычислений получается такая:
+Поток вычислений получается такой
+
+<img src="reduce.svg">
+
+В виде таблицы  где каждая строка -- вызов функции на очередном элементе массива:
+
 <table class="bordered">
  <thead>
   <tr>
    <th></th>
-   <th>`prev`</th>
+   <th>`sum`</th>
    <th>`current`</th>
    <th>результат</th>
   </tr>
@@ -188,9 +192,9 @@ alert(result); // 15
  </tbody>
 </table>
 
-Функция-аргумент `reduce` могла бы также использовать параметры `i` и `array`, но здесь в них нет нужды.
+Как видно, результат предыдущего вызова передаётся в первый аргумент следующего.
 
-**Можно сделать ещё короче!**
+Кстати, полный набор аргументов функции для `reduce` включает в себя `function(sum, current, i, array)`, то есть номер текущего вызова `i` и весь массив `arr`, но здесь в них нет нужды.
 
 Посмотрим, что будет, если не указать `initialValue` в вызове `arr.reduce`:
 
@@ -199,7 +203,7 @@ alert(result); // 15
 var arr = [1, 2, 3, 4, 5]
 
 // убрали 0 в конце
-var result = arr.reduce(function(prev, current) { return prev + current });
+var result = arr.reduce(function(sum, current) { return sum + current });
 
 alert(result); // 15
 ```