docs(stdlib): edit array/sort

ruanyf · ruanyf · commit cbf8fcf2b7d2 · 2019-10-06T10:12:56.000+08:00
diff --git a/docs/stdlib/array.md b/docs/stdlib/array.md
@@ -402,7 +402,7 @@ a // [1, 2]
 // [10111, 1101, 111]
 ```
 
-上面代码的最后两个例子，需要特殊注意。`sort`方法不是按照大小排序，而是按照字典顺序。也就是说，数值会被先转成字符串，再按照字典顺序进行比较，所以`101`排在`11`的前面。
+上面代码的最后两个例子，需要特殊注意。`sort()`方法不是按照大小排序，而是按照字典顺序。也就是说，数值会被先转成字符串，再按照字典顺序进行比较，所以`101`排在`11`的前面。
 
 如果想让`sort`方法按照自定义方式排序，可以传入一个函数作为参数。
 
@@ -430,6 +430,18 @@ a // [1, 2]
 // ]
 ```
 
+注意，自定义的排序函数应该返回数值，否则不同的浏览器可能有不同的实现，不能保证结果都一致。
+
+```javascript
+// bad
+[1, 4, 2, 6, 0, 6, 2, 6].sort((a, b) => a > b)
+
+// good
+[1, 4, 2, 6, 0, 6, 2, 6].sort((a, b) => a - b)
+```
+
+上面代码中，前一种排序算法返回的是布尔值，这是不推荐使用的。后一种是数值，才是更好的写法。
+
 ### map()
 
 `map`方法将数组的所有成员依次传入参数函数，然后把每一次的执行结果组成一个新数组返回。
diff --git a/package.json b/package.json
@@ -35,7 +35,7 @@
   "homepage": "https://github.com/wangdoc/javascript-tutorial",
   "dependencies": {
     "gh-pages": "latest",
-    "husky": "^3.0.5",
+    "husky": "^3.0.7",
     "loppo": "latest",
     "loppo-theme-wangdoc": "latest"
   }

Original file line number	Diff line number	Diff line change
`@@ -35,7 +35,7 @@`
`35`	`35`	`"homepage": "https://github.com/wangdoc/javascript-tutorial",`
`36`	`36`	`"dependencies": {`
`37`	`37`	`"gh-pages": "latest",`
`38`		`- "husky": "^3.0.5",`
	`38`	`+ "husky": "^3.0.7",`
`39`	`39`	`"loppo": "latest",`
`40`	`40`	`"loppo-theme-wangdoc": "latest"`
`41`	`41`	`}`