Boolean

概要

Boolean オブジェクトは真偽値のオブジェクト・ラッパです。

構文

new Boolean(value)

引数

value

Boolean オブジェクトの初期値。

説明

一番目の引数に渡された値は、必要に応じ真偽値に変換されます。値が省略された場合や、値が 0, -0, null, false, NaN, undefined あるいは空文字列 ("") であった場合、オブジェクトは false の初期値を持ちます。それ以外のあらゆる値は、オブジェクトや "false" という文字列も含めて、true の初期値を持つオブジェクトを生成します。

プリミティブな真偽値の true や false を Boolean オブジェクトの true や false という値と混同しないでください。

その値が undefined や null でないオブジェクトは、値が false の Boolean オブジェクトも含めて、条件文に通されると全て true に評価されます。例えば、以下の if 文の条件は true に評価されます。:

x = new Boolean(false);
if (x) {
  // . . . このコードは実行されます。
}

この振る舞いはプリミティブな真偽値には適用されません。例えば、以下の if 文の条件は false に評価されます。:

x = false;
if (x) {
  // . . . このコードは実行されません
}

Boolean オブジェクトを真偽値でない値から真偽値への変換に使わないでください。代わりに、Boolean を関数として使うことで同じことが行えます。:

x = Boolean(expression);     // 推奨
x = new Boolean(expression); // 使わないでください

Boolean オブジェクトの初期値としてオブジェクトを指定した場合、それが値が false の Boolean オブジェクトであっても、新しい Boolean オブジェクトは true の値を持ちます。

myFalse = new Boolean(false);   // 初期値は false
g = new Boolean(myFalse);       // 初期値は true
myString = new String("Hello"); // String オブジェクト
s = new Boolean(myString);      // 初期値は true

プリミティブな真偽値の代わりに Boolean オブジェクトを使わないでください。

プロパティ

Boolean インスタンスから継承されているプロパティについては、Boolean インスタンスのプロパティを参照してください。

prototype: すべての Boolean オブジェクトに共有されるプロパティを定義します。

メソッド

Boolean インスタンスから継承されているメソッドについては、Boolean インスタンスのメソッドを参照してください。

グローバル な Boolean オブジェクトは、自分自身のメソッドを持っていませんが、プロトタイプチェーンを通していくつかのメソッドを継承しています。

Boolean インスタンス

Boolean インスタンスは、Boolean.prototype を継承します。コンストラクタのプロトタイプオブジェクトを用いて、Boolean インスタンスの全てにプロパティ、もしくは、メソッドを加えることができます。

プロパティ

メソッド

例

false の初期値を持つ Boolean オブジェクトを生成する

var bNoParam = new Boolean();
var bZero = new Boolean(0);
var bNull = new Boolean(null);
var bEmptyString = new Boolean("");
var bfalse = new Boolean(false);

true の初期値を持つ Boolean オブジェクトを生成する

var btrue = new Boolean(true);
var btrueString = new Boolean("true");
var bfalseString = new Boolean("false");
var bSuLin = new Boolean("Su Lin");

ブラウザ実装状況

関連情報

• Boolean.prototype
• Boolean data type (日本語版)