From 53bae91a334d024cb6d0bd6ac7e2f1fc630142fa Mon Sep 17 00:00:00 2001
From: ruanyf <yifeng.ruan@gmail.com>
Date: Sun, 21 Apr 2019 13:47:28 +0800
Subject: [PATCH] docs(stdlib): edit wrapper

---
 docs/stdlib/wrapper.md | 50 ++++++++++++++++++------------------------
 1 file changed, 21 insertions(+), 29 deletions(-)

diff --git a/docs/stdlib/wrapper.md b/docs/stdlib/wrapper.md
index dbdb2b4..7c3367b 100644
--- a/docs/stdlib/wrapper.md
+++ b/docs/stdlib/wrapper.md
@@ -2,19 +2,15 @@
 
 ## 定义
 
-对象是 JavaScript 语言最主要的数据类型，三种原始类型的值——数值、字符串、布尔值——在一定条件下，也会自动转为对象，也就是原始类型的“包装对象”。
+对象是 JavaScript 语言最主要的数据类型，三种原始类型的值——数值、字符串、布尔值——在一定条件下，也会自动转为对象，也就是原始类型的“包装对象”（wrapper）。
 
-所谓“包装对象”，就是分别与数值、字符串、布尔值相对应的`Number`、`String`、`Boolean`三个原生对象。这三个原生对象可以把原始类型的值变成（包装成）对象。
+所谓“包装对象”，指的是与数值、字符串、布尔值分别相对应的`Number`、`String`、`Boolean`三个原生对象。这三个原生对象可以把原始类型的值变成（包装成）对象。
 
 ```javascript
 var v1 = new Number(123);
 var v2 = new String('abc');
 var v3 = new Boolean(true);
-```
 
-上面代码中，基于原始类型的值，生成了三个对应的包装对象。
-
-```javascript
 typeof v1 // "object"
 typeof v2 // "object"
 typeof v3 // "object"
@@ -24,14 +20,21 @@ v2 === 'abc' // false
 v3 === true // false
 ```
 
-包装对象的最大目的，首先是使得 JavaScript 的对象涵盖所有的值，其次使得原始类型的值可以方便地调用某些方法。
+上面代码中，基于原始类型的值，生成了三个对应的包装对象。可以看到，`v1`、`v2`、`v3`都是对象，且与对应的简单类型值不相等。
 
-`Number`、`String`和`Boolean`如果不作为构造函数调用（即调用时不加`new`），常常用于将任意类型的值转为数值、字符串和布尔值。
+包装对象的设计目的，首先是使得“对象”这种类型可以覆盖 JavaScript 所有的值，整门语言有一个通用的数据模型，其次是使得原始类型的值也有办法调用自己的方法。
+
+`Number`、`String`和`Boolean`这三个原生对象，如果不作为构造函数调用（即调用时不加`new`），而是作为普通函数调用，常常用于将任意类型的值转为数值、字符串和布尔值。
 
 ```javascript
-Number(123) // 123
-String('abc') // "abc"
-Boolean(true) // true
+// 字符串转为数值
+Number('123') // 123
+
+// 数值转为字符串
+String(123) // "123"
+
+// 数值转为布尔值
+Boolean(123) // true
 ```
 
 上面这种数据类型的转换，详见《数据类型转换》一节。
@@ -40,11 +43,11 @@ Boolean(true) // true
 
 ## 实例方法
 
-三种包装对象各自提供了许多实例方法，详见后文。这里介绍两种它们共同具有、从`Object`对象继承的方法：`valueOf`和`toString`。
+三种包装对象各自提供了许多实例方法，详见后文。这里介绍两种它们共同具有、从`Object`对象继承的方法：`valueOf()`和`toString()`。
 
 ### valueOf()
 
-`valueOf`方法返回包装对象实例对应的原始类型的值。
+`valueOf()`方法返回包装对象实例对应的原始类型的值。
 
 ```javascript
 new Number(123).valueOf()  // 123
@@ -54,7 +57,7 @@ new Boolean(true).valueOf() // true
 
 ### toString()
 
-`toString`方法返回对应的字符串形式。
+`toString()`方法返回对应的字符串形式。
 
 ```javascript
 new Number(123).toString() // "123"
@@ -64,7 +67,7 @@ new Boolean(true).toString() // "true"
 
 ## 原始类型与实例对象的自动转换
 
-原始类型的值，可以自动当作包装对象调用，即调用包装对象的属性和方法。这时，JavaScript 引擎会自动将原始类型的值转为包装对象实例，在使用后立刻销毁实例。
+某些场合，原始类型的值会自动当作包装对象调用，即调用包装对象的属性和方法。这时，JavaScript 引擎会自动将原始类型的值转为包装对象实例，并在使用后立刻销毁实例。
 
 比如，字符串可以调用`length`属性，返回字符串的长度。
 
@@ -86,7 +89,7 @@ var strObj = new String(str)
 strObj.length // 3
 ```
 
-上面代码中，字符串`abc`的包装对象提供了多个属性。
+上面代码中，字符串`abc`的包装对象提供了多个属性，`length`只是其中之一。
 
 自动转换生成的包装对象是只读的，无法修改。所以，字符串无法添加新属性。
 
@@ -118,19 +121,8 @@ Number.prototype.double = function () {
   return this.valueOf() + this.valueOf();
 };
 
-(123).double()
-// 246
+(123).double() // 246
 ```
 
-上面代码在`123`外面必须要加上圆括号，否则后面的点运算符（`.`）会被解释成小数点。
+上面代码在`String`和`Number`这两个对象的原型上面，分别自定义了一个方法，从而可以在所有实例对象上调用。注意，最后一张的`123`外面必须要加上圆括号，否则后面的点运算符（`.`）会被解释成小数点。
 
-但是，这种自定义方法和属性的机制，只能定义在包装对象的原型上，如果直接对原始类型的变量添加属性，则无效。
-
-```javascript
-var s = 'abc';
-
-s.p = 123;
-s.p // undefined
-```
-
-上面代码直接对字符串`abc`添加属性，结果无效。主要原因是上面说的，这里的包装对象是自动生成的，赋值后自动销毁，所以最后一行实际上调用的是一个新的包装对象。