docs(stdlib): add boolean

chapters.yml

@@ -1,6 +1,7 @@
-- introduction.md: 导论
-- history.md: 历史
-- grammar.md: 基本语法
+- basic/: 入门篇
+- basic/introduction.md: 导论
+- basic/history.md: 历史
+- basic/grammar.md: 基本语法
 - types/: 数据类型
 - types/general.md: 概述
 - types/null-undefined-boolean.md: null，undefined 和布尔值
@@ -24,5 +25,6 @@
 - stdlib/attributes.md: 属性描述对象
 - stdlib/array.md: Array 对象
 - stdlib/wrapper.md: 包装对象
+- stdlib/boolean.md: Boolean 对象
 - advanced/: 高级语法
 - advanced/strict.md: 严格模式

docs/stdlib/boolean.md

@@ -0,0 +1,85 @@
+# Boolean 对象
+
+## 概述
+
+`Boolean`对象是 JavaScript 的三个包装对象之一。作为构造函数，它主要用于生成布尔值的包装对象实例。
+
+```javascript
+var b = new Boolean(true);
+
+typeof b // "object"
+b.valueOf() // true
+```
+
+上面代码的变量`b`是一个`Boolean`对象的实例，它的类型是对象，值为布尔值`true`。
+
+注意，`false`对应的包装对象实例，布尔运算结果也是`true`。
+
+```javascript
+if (new Boolean(false)) {
+  console.log('true');
+} // true
+
+if (new Boolean(false).valueOf()) {
+  console.log('true');
+} // 无输出
+```
+
+上面代码的第一个例子之所以得到`true`，是因为`false`对应的包装对象实例是一个对象，进行逻辑运算时，被自动转化成布尔值`true`（因为所有对象对应的布尔值都是`true`）。而实例的`valueOf`方法，则返回实例对应的原始值，本例为`false`。
+
+## Boolean 函数的类型转换作用
+
+`Boolean`对象除了可以作为构造函数，还可以单独使用，将任意值转为布尔值。这时`Boolean`就是一个单纯的工具方法。
+
+```javascript
+Boolean(undefined) // false
+Boolean(null) // false
+Boolean(0) // false
+Boolean('') // false
+Boolean(NaN) // false
+
+Boolean(1) // true
+Boolean('false') // true
+Boolean([]) // true
+Boolean({}) // true
+Boolean(function () {}) // true
+Boolean(/foo/) // true
+```
+
+上面代码中几种得到`true`的情况，都值得认真记住。
+
+顺便提一下，使用双重的否运算符（`!`）也可以将任意值转为对应的布尔值。
+
+```javascript
+!!undefined // false
+!!null // false
+!!0 // false
+!!'' // false
+!!NaN // false
+!!1 // true
+!!'false' // true
+!![] // true
+!!{} // true
+!!function(){} // true
+!!/foo/ // true
+```
+
+最后，对于一些特殊值，`Boolean`对象前面加不加`new`，会得到完全相反的结果，必须小心。
+
+```javascript
+if (Boolean(false)) {
+  console.log('true');
+} // 无输出
+
+if (new Boolean(false)) {
+  console.log('true');
+} // true
+
+if (Boolean(null)) {
+  console.log('true');
+} // 无输出
+
+if (new Boolean(null)) {
+  console.log('true');
+} // true
+```

docs/stdlib/wrapper.md

@@ -40,7 +40,7 @@ Boolean(true) // true
 
 ## 实例方法
 
-包装对象的实例可以使用`Object`对象提供的原生方法，主要是`valueOf`方法和`toString`方法。
+三种包装对象各自提供了许多实例方法，详见后文。这里介绍两种它们共同具有、从`Object`对象继承的方法：`valueOf`和`toString`。
 
 ### valueOf()
 
@@ -102,7 +102,7 @@ s.x // undefined
 
 ## 自定义方法
 
-三种包装对象除了提供很多原生的实例方法（详见后文的介绍），还可以在原型上添加自定义方法和属性，供原始类型的值直接调用。
+除了原生的实例方法，包装对象还可以自定义方法和属性，供原始类型的值直接调用。
 
 比如，我们可以新增一个`double`方法，使得字符串和数字翻倍。