Merge pull request ruanyf#2 from ruanyf/gh-pages

picc-lu · web-flow · commit 8aa99b93022e · 2018-01-06T18:39:20.000+08:00
Update 18.01.06
diff --git a/docs/function.md b/docs/function.md
@@ -944,7 +944,7 @@ let log = ::console.log;
 var log = console.log.bind(console);
 ```
 
-双冒号运算符的运算结果，还是一个对象，因此可以采用链式写法。
+双冒号运算符的运算结果，还是一个函数，因此可以采用链式写法。
 
 ```javascript
 // 例一
diff --git a/docs/number.md b/docs/number.md
@@ -132,41 +132,53 @@ Number.parseFloat === parseFloat // true
 
 ## Number.isInteger()
 
-`Number.isInteger()`用来判断一个值是否为整数。需要注意的是，在 JavaScript 内部，整数和浮点数是同样的储存方法，所以 3 和 3.0 被视为同一个值。
+`Number.isInteger()`用来判断一个数值是否为整数。
 
 ```javascript
 Number.isInteger(25) // true
-Number.isInteger(25.0) // true
 Number.isInteger(25.1) // false
-Number.isInteger("15") // false
+```
+
+JavaScript 内部，整数和浮点数采用的是同样的储存方法，所以 25  和 25.0 被视为同一个值。
+
+```javascript
+Number.isInteger(25) // true
+Number.isInteger(25.0) // true
+```
+
+如果参数不是数值，`Number.isInteger`返回`false`。
+
+```javascript
+Number.isInteger() // false
+Number.isInteger(null) // false
+Number.isInteger('15') // false
 Number.isInteger(true) // false
 ```
 
-ES5 可以通过下面的代码，部署`Number.isInteger()`。
+注意，由于 JavaScript 采用 IEEE 754 标准，数值存储为64位双精度格式，数值精度最多可以达到 53 个二进制位（1 个隐藏位与 52 个有效位）。如果数值的精度超过这个限度，第54位及后面的位就会被丢弃，这种情况下，`Number.isInteger`可能会误判。
 
 ```javascript
-(function (global) {
-  var floor = Math.floor,
-    isFinite = global.isFinite;
-
-  Object.defineProperty(Number, 'isInteger', {
-    value: function isInteger(value) {
-      return typeof value === 'number' &&
-        isFinite(value) &&
-        floor(value) === value;
-    },
-    configurable: true,
-    enumerable: false,
-    writable: true
-  });
-})(this);
+Number.isInteger(3.0000000000000002) // true
 ```
 
+上面代码中，`Number.isInteger`的参数明明不是整数，但是会返回`true`。原因就是这个小数的精度达到了小数点后16个十进制位，转成二进制位超过了53个二进制位，导致最后的那个`2`被丢弃了。
+
+类似的情况还有，如果一个数值的绝对值小于`Number.MIN_VALUE`（5E-324），即小于 JavaScript 能够分辨的最小值，会被自动转为 0。这时，`Number.isInteger`也会误判。
+
+```javascript
+Number.isInteger(5E-324) // false
+Number.isInteger(5E-325) // true
+```
+
+上面代码中，`5E-325`由于值太小，会被自动转为0，因此返回`true`。
+
+总之，如果对数据精度的要求较高，不建议使用`Number.isInteger()`判断一个数值是否为整数。
+
 ## Number.EPSILON
 
 ES6 在`Number`对象上面，新增一个极小的常量`Number.EPSILON`。根据规格，它表示 1 与大于 1 的最小浮点数之间的差。
 
-对于 64 位浮点数来说，大于 1 的最小浮点数相当于二进制的`1.00..001`，小数点后面有连续 51 个零。这个值减去 1 之后，就等于 2 的-52 次方。
+对于 64 位浮点数来说，大于 1 的最小浮点数相当于二进制的`1.00..001`，小数点后面有连续 51 个零。这个值减去 1 之后，就等于 2 的 -52 次方。
 
 ```javascript
 Number.EPSILON === Math.pow(2, -52)
@@ -510,22 +522,53 @@ Math.imul(0x7fffffff, 0x7fffffff) // 1
 
 ### Math.fround()
 
-Math.fround 方法返回一个数的单精度浮点数形式。
+`Math.fround`方法返回一个数的32位单精度浮点数形式。
+
+对于32位单精度格式来说，数值精度是24个二进制位（1 位隐藏位与 23 位有效位），所以对于 -2<sup>24</sup> 至 2<sup>24</sup> 之间的整数（不含两个端点），返回结果与参数本身一致。
+
+```javascript
+Math.fround(0)   // 0
+Math.fround(1)   // 1
+Math.fround(2 ** 24 - 1)   // 16777215
+```
+
+如果参数的绝对值大于 2<sup>24</sup>，返回的结果便开始丢失精度。
 
 ```javascript
-Math.fround(0)     // 0
-Math.fround(1)     // 1
-Math.fround(1.337) // 1.3370000123977661
-Math.fround(1.5)   // 1.5
-Math.fround(NaN)   // NaN
+Math.fround(2 ** 24)       // 16777216
+Math.fround(2 ** 24 + 1)   // 16777216
 ```
 
-对于整数来说，`Math.fround`方法返回结果不会有任何不同，区别主要是那些无法用 64 个二进制位精确表示的小数。这时，`Math.fround`方法会返回最接近这个小数的单精度浮点数。
+`Math.fround`方法的主要作用，是将64位双精度浮点数转为32位单精度浮点数。如果小数的精度超过24个二进制位，返回值就会不同于原值，否则返回值不变（即与64位双精度值一致）。
+
+```javascript
+// 未丢失有效精度
+Math.fround(1.125) // 1.125
+Math.fround(7.25)  // 7.25
+
+// 丢失精度
+Math.fround(0.3)   // 0.30000001192092896
+Math.fround(0.7)   // 0.699999988079071
+Math.fround(1.0000000123) // 1
+```
+
+对于 `NaN` 和 `Infinity`，此方法返回原值。对于其它类型的非数值，`Math.fround` 方法会先将其转为数值，再返回单精度浮点数。
+
+```javascript
+Math.fround(NaN)      // NaN
+Math.fround(Infinity) // Infinity
+
+Math.fround('5')      // 5
+Math.fround(true)     // 1
+Math.fround(null)     // 0
+Math.fround([])       // 0
+Math.fround({})       // NaN
+```
 
 对于没有部署这个方法的环境，可以用下面的代码模拟。
 
 ```javascript
-Math.fround = Math.fround || function(x) {
+Math.fround = Math.fround || function (x) {
   return new Float32Array([x])[0];
 };
 ```
