Boolean

Объект Boolean является объектом-обёрткой над примитивом логического типа.

Синтаксис

new Boolean([value])

Параметры

value
Необязательный параметр. Начальное значение объекта Boolean.

Описание

Значение, переданное первым параметрои, при необходимости преобразуется в логическое значение. Если значение опущено или равно 0, -0, null, false, NaN, undefined или пустой строке (""), объект имеет начальное значение, равное false. Все остальные значения, включая любые объекты или строку "false", создают объект с начальным значением, равным true.

Не путайте примитивные значения true и false логического типа со значениями true и false объекта Boolean.

Любой объект, чьё значение не является равным undefined или null, включая сам объект Boolean со значением, равным false, вычисляется в true при передаче его в условное выражение. Например, условие в следующей инструкции if вычисляется в true:

var x = new Boolean(false);
if (x) {
  // этот код будет выполнен
}

Это поведение не применяется к примитивам логического типа. Например, условие в следующей инструкции if вычисляется в false:

var x = false;
if (x) {
  // этот код не будет выполнен
}

Не используйте объект Boolean для преобразования нелогического значения в логическое значение. Вместо этого используйте Boolean в качестве функции:

var x = Boolean(expression);     // предпочтительно
var x = new Boolean(expression); // не используйте

Если вы определите любой объект, включая объект Boolean со значением false, в качестве начального значения объекта Boolean, новый объект Boolean будет иметь значение true.

var myFalse = new Boolean(false);    // начальное значение равно false
var g = new Boolean(myFalse);        // начальное значение равно true
var myString = new String('Привет'); // строковый объект
var s = new Boolean(myString);       // начальное значение равно true

Не используйте объект Boolean заместо примитива логического типа.

Свойства

Справку по свойствам, доступным на экземплярах Boolean, смотрите в разделе Свойства экземпляров Boolean.
Boolean.length
Свойство length логического значения равно 1.
Boolean.prototype
Представляет прототип конструктора объекта Boolean.

Свойства, унаследованные из Function:

Методы

Справку по методам, доступным на экземплярах Boolean, смотрите в разделе Методы экземпляров Boolean.

Глобальный объект Boolean не содержит собственных методов, однако, он наследует некоторые методы из цепочки прототипов:

Методы, унаследованные из Function:

Экземпляры объекта Boolean

Все экземпляры объекта Boolean наследуются от Boolean.prototype. Как и все конструкторы, объект прототипа предоставляет экземплярам свойства и методы.

Свойства

Boolean.prototype.constructor
Возвращает функцию, создающую экземпляр прототипа. По умолчанию, это функция Boolean.
Свойства, унаследованные из Object:

Методы

Boolean.prototype.toSource()
Возвращает строку, содержащую исходный код объекта Boolean; вы можете использовать эту строку для создания эквивалентного объекта. Переопределяет метод Object.prototype.toSource().
Boolean.prototype.toString()
Возвращает строку "true" или "false", в зависимости от значения объекта. Переопределяет метод Object.prototype.toString().
Boolean.prototype.valueOf()
Возвращает примитивное значение объекта Boolean. Переопределяет метод Object.prototype.valueOf().

Примеры

Пример: создание объектов Boolean с начальным значением, равным false

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

Пример: создание объектов Boolean с начальным значением, равным true

var btrue = new Boolean(true);
var btrueString = new Boolean('true');
var bfalseString = new Boolean('false');
var bSuLin = new Boolean('Су Лин');
var bArrayProto = new Boolean([]);
var bObjProto = new Boolean({});

Спецификации

Спецификация Статус Комментарии
ECMAScript 1-е издание. Стандарт Изначальное определение. Реализована в JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Определение 'Boolean' в этой спецификации.
Стандарт  
ECMAScript 6 (ECMA-262)
Определение 'Boolean' в этой спецификации.
Кандидат в рекомендации  

Совместимость с браузерами

Возможность Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) (Да) 6.0 (Да) (Да)
Возможность Android Chrome для Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) (Да) (Да) (Да) (Да) (Да)

Смотрите также

Метки документа и участники

 Внесли вклад в эту страницу: Aleksej, AlexChuev, Mingun, Troynov
 Обновлялась последний раз: Aleksej,