Boolean
Определение и применение
Boolean — встроенная функция для преобразования значения в логический тип. Вызов
Boolean(value) возвращает true или false, например помогает превратить наличие
текста в отдельный признак. Вызов с new создаёт объект-обёртку (даже
new Boolean(false) считается истинным в условии).
Применение признаков разобрано в уроке «Логический тип». Сравнить преобразования разных значений можно в тренажёре типов и преобразований.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
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
Синтаксис и результат
Boolean(value);
Boolean();
new Boolean(value);
value — исходное значение любого типа. Без аргумента результат равен false. Исходные данные
не меняются. Преобразование не проверяет содержимое текста: например, Boolean(" ") возвращает
true, потому что строка из пробела непустая.
Какие значения дают false
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.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.
Спецификация
Примеры, попробуйте сами
Истинность значения и проверка текста
Сравните пустую строку, слово false и строку из пробела. Замените text на true: только проверка конкретного текста изменит смысл.
index.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
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 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
const wrapped = new Boolean(false);
console.log(typeof false, typeof wrapped);
console.log(Boolean(wrapped), wrapped.valueOf());
console.log(wrapped.toString());
Нажмите , чтобы запустить пример.