Boolean() constructor

Try it

const flag = new Boolean();
console.log(typeof flag);
// Expected output: object
console.log(flag === false);
// Expected output: false

const flag2 = Boolean();
console.log(typeof flag2);
// Expected output: boolean
console.log(flag2 === false);
// Expected output: true

Syntax

new Boolean(value)
Boolean(value)

Parameters

value

The initial value of the Boolean object.

Return value

When Boolean() is called as a function (without new), it returns value coerced to a boolean primitive.

When Boolean() is called as a constructor (with new), it coerces value to a boolean primitive and returns a wrapping Boolean object, which is not a primitive.

Description

The value passed as the first parameter is converted to a boolean value. If the value is omitted or is 0, -0, 0n, null, false, NaN, undefined, or the empty string (""), then the object has an initial value of false. All other values, including any object, an empty array ([]), or the string "false", create an object with an initial value of true.

Examples

Creating Boolean objects with an initial value of false

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

typeof bfalse; // "object"
Boolean(bfalse); // true

Note how converting a Boolean object to a primitive with Boolean() always yields true, even if the object holds a value of false. You are therefore always advised to avoid constructing Boolean wrapper objects.

If you need to take the primitive value out from the wrapper object, instead of using the Boolean() function, use the object's valueOf() method instead.

const bfalse = new Boolean(false);

bfalse.valueOf(); // false

Creating Boolean objects with an initial value of true

const btrue = new Boolean(true);
const btrueString = new Boolean("true");
const bfalseString = new Boolean("false");
const bSuLin = new Boolean("Su Lin");
const bArrayProto = new Boolean([]);
const bObjProto = new Boolean({});

Specifications

Browser compatibility

See also

• Boolean