aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/javascript/reference/global_objects/boolean/index.html
blob: 9b0ba4ae066213c2ba7b40cb0d2262b2aa3c5313 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
---
title: Boolean
slug: Web/JavaScript/Reference/Global_Objects/Boolean
tags:
  - Boolean
  - Constructor
  - JavaScript
translation_of: Web/JavaScript/Reference/Global_Objects/Boolean
---
<p>{{JSRef}}</p>

<p><strong><code>Boolean</code></strong>对象是一个布尔值的对象包装器。</p>

<h2 id="描述">描述</h2>

<p>如果需要,作为第一个参数传递的值将转换为布尔值。如果省略或值<code>0</code><code>-0</code>{{jsxref("null")}}<code>false</code>{{jsxref("NaN")}}{{jsxref("undefined")}},或空字符串(<code>""</code>),该对象具有的初始值<code>false</code>。所有其他值,包括任何对象,空数组(<code>[]</code>)或字符串<code>"false"</code>,都会创建一个初始值为<code>true</code>的对象。</p>

<p>注意不要将基本类型中的布尔值 <code>true</code> 和 <code>false</code> 与值为 <code>true</code> 和 <code>false</code> 的 <code>Boolean</code> 对象弄混了。</p>

<p>其值不是{{jsxref("undefined")}}{{jsxref("null")}}的任何对象(包括其值为<code>false</code>的布尔对象)在传递给条件语句时都将计算为<code>true</code>。 例如,以下{{jsxref("Statements/if...else", "if")}}语句中的条件评估为<code>true</code></p>

<pre class="brush: js notranslate">var x = new Boolean(false);
if (x) {
  // 这里的代码会被执行
}
</pre>

<p>基本类型的布尔值不受此规则影响。例如下面的 {{jsxref("Statements/if...else", "if")}} 语句的条件为假:</p>

<pre class="brush: js notranslate">var x = false;
if (x) {
  // 这里的代码不会执行
}
</pre>

<p>不要用创建 <code>Boolean</code> 对象的方式将一个非布尔值转化成布尔值,直接将 <code>Boolean</code> 当做转换函数来使用即可,或者使用<a href="/zh-CN/docs/Web/JavaScript/Reference/Operators/Logical_Operators#%E9%80%BB%E8%BE%91%E9%9D%9E%EF%BC%88!%EF%BC%89">双重非(!!)运算符</a></p>

<pre class="brush: js notranslate">var x = Boolean(expression);     // 推荐
var x = !!(expression);          // 推荐
var x = new Boolean(expression); // 不太好
</pre>

<p>对于任何对象,即使是值为 <code>false</code><code>Boolean</code> 对象,当将其传给 <code>Boolean</code> 函数时,生成的 <code>Boolean</code> 对象的值都是 <code>true</code></p>

<pre class="brush: js notranslate">var myFalse = new Boolean(false);   // true
var g = new Boolean(myFalse);       // true
var myString = new String("Hello");
var s = new Boolean(myString);      // true
</pre>

<p>最后,不要在应该使用基本类型布尔值的地方使用 <code>Boolean</code> 对象。</p>

<div class="blockIndicator note">
<p><strong>注意:</strong>当将非标准属性<a href="https://wiki.developer.mozilla.org/en-US/docs/Web/API/Document#Properties">document.all</a>用作此构造函数的参数时,结果是值为<code>false</code>的布尔对象。 此属性是旧属性,是非标准属性,不应使用。</p>
</div>

<h2 id="构造器">构造器</h2>

<dl>
 <dt><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean/Boolean"><code>Boolean()</code></a></dt>
 <dd>创建一个新的<code>Boolean</code> 对象。</dd>
</dl>

<h2 id="实例方法">实例方法</h2>

<dl>
 <dt>{{jsxref("Boolean.prototype.toString()")}}</dt>
 <dd>根据对象的值返回字符串<code>"true"</code><code>"false"</code>。 重写{{jsxref("Object.prototype.toString()")}}方法。</dd>
 <dt>{{jsxref("Boolean.prototype.valueOf()")}}</dt>
 <dd>返回{{jsxref("Boolean")}}对象的原始值。 重写{{jsxref("Object.prototype.valueOf()")}}方法。</dd>
</dl>

<h2 id="示例">示例</h2>

<h3 id="创建值为_false_的_Boolean_对象">创建值为 <code>false</code> 的 <code>Boolean</code> 对象</h3>

<pre class="brush: js notranslate">var bNoParam = new Boolean();
var bZero = new Boolean(0);
var bNull = new Boolean(null);
var bEmptyString = new Boolean('');
var bfalse = new Boolean(false);
</pre>

<h3 id="创建值为_true_的_Boolean_对象">创建值为 <code>true</code> 的  <code>Boolean</code> 对象</h3>

<pre class="brush: js notranslate">var btrue = new Boolean(true);
var btrueString = new Boolean('true');
var bfalseString = new Boolean('false');
var bSuLin = new Boolean('Su Lin');
var bArrayProto = new Boolean([]);
var bObjProto = new Boolean({});
</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td>规范</td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-boolean-objects', 'Boolean')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性"><br>
 浏览器兼容性</h2>

<p>{{Compat("javascript.builtins.Boolean")}}</p>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li>{{jsxref("Boolean.prototype")}}</li>
 <li>{{Glossary("Boolean")}}</li>
 <li><a href="http://en.wikipedia.org/wiki/Boolean_data_type">Boolean data type (Wikipedia)</a></li>
</ul>