Merge pull request #602 from javascript-tutorial/leviding-patch-4

Update translation of 1-js/05-data-types/05-array-methods

Author: leviding

1-js/05-data-types/05-array-methods/1-camelcase/_js.view/solution.js

@@ -1,8 +1,10 @@
 function camelize(str) {
   return str
-    .split('-') // my-long-word -> ['my', 'long', 'word']
-    .map( 
+    .split('-') // splits 'my-long-word' into array ['my', 'long', 'word']
+    .map(
+      // capitalizes first letters of all array items except the first one
+      // converts ['my', 'long', 'word'] into ['my', 'Long', 'Word']
       (word, index) => index == 0 ? word : word[0].toUpperCase() + word.slice(1)
-    ) // ['my', 'long', 'word'] -> ['my', 'Long', 'Word']
-    .join(''); // ['my', 'Long', 'Word'] -> myLongWord
+    )
+    .join(''); // joins ['my', 'Long', 'Word'] into 'myLongWord'
 }

1-js/05-data-types/05-array-methods/1-camelcase/task.md

@@ -4,16 +4,16 @@ importance: 5
 
 # 将 border-left-width 转换成 borderLeftWidth
 
-写函数 `camelize(str)` 将诸如 "my-short-string" 之类的由短划线分隔的单词变成骆驼式的 "myShortString"。
+编写函数 `camelize(str)` 将诸如 "my-short-string" 之类的由短划线分隔的单词变成骆驼式的 "myShortString"。
 
-即：删除所有短横线，短横线后的每一个单词变为首字母大写。
+即：删除所有短横线，并将短横线后的每一个单词的首字母变为大写。
 
-例如：
+示例：
 
 ```js
 camelize("background-color") == 'backgroundColor';
 camelize("list-style-image") == 'listStyleImage';
 camelize("-webkit-transition") == 'WebkitTransition';
 ```
 
-提示：使用 `split` 将字符串拆分成数组，然后将其转换 `join` 并返回。
+提示：使用 `split` 将字符串拆分成数组，对其进行转换之后再 `join` 回来。

1-js/05-data-types/05-array-methods/10-average-age/task.md

@@ -2,11 +2,11 @@ importance: 4
 
 ---
 
-# 获取平均
+# 获取平均年龄
 
-编写 `getAverageAge(users)` 函数，该函数获取一个具有 age 属性的对象数组，并获取平均值。
+编写 `getAverageAge(users)` 函数，该函数获取一个具有 `age` 属性的对象数组，并返回平均年龄。
 
-平均的公式是 `(age1 + age2 + ... + ageN) / N`。
+平均值的计算公式是 `(age1 + age2 + ... + ageN) / N`。
 
 例如：
 
@@ -19,4 +19,3 @@ let arr = [ john, pete, mary ];
 
 alert( getAverageAge(arr) ); // (25 + 30 + 29) / 3 = 28
 ```
-

1-js/05-data-types/05-array-methods/11-array-unique/solution.md

@@ -1,8 +1,8 @@
-遍历数组
+让我们先遍历数字：
 - 对于每个元素，我们将检查结果数组是否已经有该元素。
-- 如果有，则忽略，否则添加结果。
+- 如果有，则忽略，否则将其添加到结果中。
 
-```js run
+```js run demo
 function unique(arr) {
   let result = [];
 
@@ -24,16 +24,16 @@ alert( unique(strings) ); // Hare, Krishna, :-O
 
 代码有效，但其中存在潜在的性能问题。
 
-方法 `result.includes(str)` 在内部遍历数组 `result` 并将每个元素与 `str` 进行比较以找到匹配项。
+方法 `result.includes(str)` 在内部遍历数组 `result`，并将每个元素与 `str` 进行比较以找到匹配项。
 
-所以如果 `result` 中有 `100` 个元素，并且没有一个匹配上 `str`，那么它将遍历整个 `result` 并进行完全的 `100` 比较。如果 `result` 很大，比如 `10000`，那么会有 `10000` 次的比较。
+所以如果 `result` 中有 `100` 个元素，并且没有任何一项与 `str` 匹配，那么它将遍历整个 `result` 并进行 `100` 次比较。如果 `result` 很大，比如 `10000`，那么就会有 `10000` 次的比较。
 
-这本身并不是问题，因为 JavaScript 引擎速度非常快，所以遍历 10000 次就是几微秒的事。
+这本身并不是问题，因为 JavaScript 引擎速度非常快，所以遍历一个有 `10000` 个元素的数组只需要几微秒。
 
-但是我们在 `for `循环中为 `arr` 的每个元素做了这样的测试。
+但是我们在 `for `循环中对 `arr` 的每个元素都进行了一次检测。
 
-所以如果 `arr.length` 是 `10000`，我们会有 `10000 * 10000` = 100 百万的比较。好多啊。
+因此，如果 `arr.length` 是 `10000`，我们会有 `10000 * 10000` = 1 亿次的比较。那真的太多了。
 
 所以该解决方案仅适用于小型数组。
 
-进一步，在 <info:map-set-weakmap-weakset> 我们将看到如何优化它。
+进一步，在后面的 <info:map-set> 一章中，我们将看到如何对该方法进行优化。

1-js/05-data-types/05-array-methods/11-array-unique/task.md

@@ -4,9 +4,9 @@ importance: 4
 
 # 数组去重
 
-`arr` 是一个数组
+`arr` 是一个数组。
 
-创建一个函数 `unique(arr)`，返回去除重复元素的 arr。
+创建一个函数 `unique(arr)`，返回去除重复元素后的数组 `arr`。
 
 例如：
 

1-js/05-data-types/05-array-methods/12-reduce-object/task.md

@@ -4,7 +4,7 @@ importance: 4
 
 # 从数组创建键（值）对象
 
-假设我们有以下形式的用户数组 `{id:..., name:..., age... }`。
+假设我们收到了一个用户数组，形式为：`{id:..., name:..., age... }`。
 
 创建一个函数 `groupById(arr)` 从该数组创建对象，以 `id` 为键（key），数组项为值。
 
@@ -20,7 +20,7 @@ let users = [
 let usersById = groupById(users);
 
 /*
-// 调用方法后我们得到:
+// 调用函数后我们得到：
 
 usersById = {
   john: {id: 'john', name: "John Smith", age: 20}
@@ -31,8 +31,8 @@ usersById = {
 ```
 
 
-处理服务端数据时，此功能很有用。
+处理服务端数据时，这个函数很有用。
 
-在这个任务里我们假设 `id` 是唯一的。没有哪两个数组项具有相同的 `id` 。
+在这个任务里我们假设 `id` 是唯一的。没有两个具有相同 `id` 的数组项。
 
-请使用数组 `.reduce` 方法解决。
+请在解决方案中使用数组的 `.reduce` 方法。

1-js/05-data-types/05-array-methods/2-filter-range/solution.md

@@ -0,0 +1,14 @@
+```js run demo
+function filterRange(arr, a, b) {
+  // added brackets around the expression for better readability
+  return arr.filter(item => (a <= item && item <= b));
+}
+
+let arr = [5, 3, 8, 1];
+
+let filtered = filterRange(arr, 1, 4);
+
+alert( filtered ); // 3,1 (matching values)
+
+alert( arr ); // 5,3,8,1 (not modified)
+```

1-js/05-data-types/05-array-methods/2-filter-range/task.md

@@ -4,7 +4,7 @@ importance: 4
 
 # 过滤范围
 
-写一个函数 `filterRange(arr, a, b)` 获取一个数组 `arr`，查找 `a` 和 `b` 之间的元素并返回它们的数组。
+写一个函数 `filterRange(arr, a, b)`，该函数获取一个数组 `arr`，在其中查找数值大小在 `a` 和 `b` 之间的元素，并返回它们的数组。
 
 该函数不应该修改原数组。它应该返回新的数组。
 

1-js/05-data-types/05-array-methods/3-filter-range-in-place/_js.view/solution.js

@@ -1,5 +1,4 @@
 
-
 function filterRangeInPlace(arr, a, b) {
 
   for (let i = 0; i < arr.length; i++) {
@@ -12,4 +11,4 @@ function filterRangeInPlace(arr, a, b) {
     }
   }
 
-}
+}

1-js/05-data-types/05-array-methods/3-filter-range-in-place/solution.md

@@ -0,0 +1,21 @@
+```js run demo
+function filterRangeInPlace(arr, a, b) {
+
+  for (let i = 0; i < arr.length; i++) {
+    let val = arr[i];
+
+    // remove if outside of the interval
+    if (val < a || val > b) {
+      arr.splice(i, 1);
+      i--;
+    }
+  }
+
+}
+
+let arr = [5, 3, 8, 1];
+
+filterRangeInPlace(arr, 1, 4); // removed the numbers except from 1 to 4
+
+alert( arr ); // [3, 1]
+```