Boolean

Определение и применение

Boolean — встроенная функция для преобразования значения в логический тип. Вызов Boolean(value) возвращает true или false, например помогает превратить наличие текста в отдельный признак. Вызов с new создаёт объект-обёртку (даже new Boolean(false) считается истинным в условии).

Применение признаков разобрано в уроке «Логический тип». Сравнить преобразования разных значений можно в тренажёре типов и преобразований.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Boolean
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
Boolean✓1✓12✓1✓3✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
new Boolean()✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
toString✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
valueOf✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис и результат

JavaScript
Boolean(value);
Boolean();
new Boolean(value);

value — исходное значение любого типа. Без аргумента результат равен false. Исходные данные не меняются. Преобразование не проверяет содержимое текста: например, Boolean(" ") возвращает true, потому что строка из пробела непустая.

Какие значения дают false

JavaScript
Boolean(false);        // false
Boolean(0);            // false
Boolean(-0);           // false
Boolean(0n);           // false
Boolean("");           // false
Boolean(null);         // false
Boolean(undefined);    // false
Boolean(NaN);          // false
Boolean(document.all); // false

Строки "false", "0" и " " непустые и дают true. Обычные объекты, включая пустые массивы, тоже истинны. Историческое браузерное исключение — document.all (такое поведение сохранено для совместимости со старыми сайтами).

Если в поле допустимы только строки "true" и "false", проверяйте конкретный текст, например value === "true". Boolean(value) не разбирает написанное слово. Отличие показано в примере преобразований.

Почему new Boolean(false) истинно

Объект-обёртка хранит логическое значение внутри себя, но при проверке условия остаётся объектом. Поэтому Boolean(new Boolean(false)) равно true. Для обычных флагов используйте примитивы true/false или преобразование без new. Получить сохранённый примитив позволяет valueOf(), как в примере с обёрткой.

Свойства и методы

Собственные свойства Boolean и его прототипа
Имя Назначение
Boolean.length Число объявленных параметров функции: 1. Это не количество возможных логических значений.
Boolean.name Имя функции: строка "Boolean".
Boolean.prototype Общий прототип объектов-обёрток. Сам хранит логическое значение false.
Boolean.prototype.constructor Ссылка на конструктор Boolean.
Boolean.prototype.valueOf() Возвращает сохранённый логический примитив. Работает с логическими примитивами и их обёртками.
Boolean.prototype.toString() Возвращает строку "true" или "false".

У Boolean нет собственных статических методов и собственных символьных свойств по спецификации. Возможности, унаследованные от Function (например, call(), apply(), bind()) и Object (например, hasOwnProperty(), isPrototypeOf()), в таблице не перечислены. Методы прототипа не выполняют произвольное преобразование: вызов Boolean.prototype.valueOf.call("false") завершится TypeError.

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

ECMAScript: Boolean Objects.

Примеры, попробуйте сами

Истинность значения и проверка текста

Сравните пустую строку, слово false и строку из пробела. Замените text на true: только проверка конкретного текста изменит смысл.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Истинность значения и проверка текста</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const text = "false";
console.log(Boolean(""), Boolean(text), Boolean(" "));
console.log(text === "true");
console.log(Boolean(0), Boolean(null), Boolean(undefined), Boolean(NaN));
console.log(Boolean([]), Boolean({}));

Примитив и объект-обёртка

Внутри wrapped хранится false, но сам объект истинен. Замените false на true и сравните Boolean(wrapped) с wrapped.valueOf().

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Примитив и объект-обёртка</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const wrapped = new Boolean(false);
console.log(typeof false, typeof wrapped);
console.log(Boolean(wrapped), wrapped.valueOf());
console.log(wrapped.toString());