Boolean
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
O objeto Boolean é um objeto wrapper para um valor booleano.
Sintaxe
new Boolean([value])
Parâmetros
value-
Opcional. O valor inicial do objeto
Boolean.
Descrição
O valor passado como primeiro parâmetro é convertido para um valor boleano, se necessário. Se o valor é omitido ou é 0, -0, null, false, NaN, undefined ou é uma string vazia(""), o objeto terá um valor inicial de false. Todos outros valores, incluindo qualquer objeto ou string "false", criam um objeto com valor inicial true.
Não confunda os valores primitivos Boolean true e false com os valores true and false do objeto Boolean.
Qualquer objeto cujo o valor não é undefined ou null, incluindo um objeto Boolean que o valor seja false, é avaliado para true quando passa por uma declaração condicional. Por exemplo, a condição a seguir if a declaração é avaliada como true:
var x = new Boolean(false); if (x) { // esse código é executado } Esse comportamento não se aplica aos primitivos Boolean. Por exemplo, a condição a seguir if a declaração é avaliada como false:
var x = false; if (x) { // esse código não é executado } Não use um objeto Boolean para converter um valor não-boleano para um valor boleano. Ao invés disso use Boolean como uma função para executar essa tarefa:
var x = Boolean(expression); // preferido var x = new Boolean(expression); // não use Se você especificar qualquer objeto, incluindo um objeto Boolean cujo valor é false, como valor inicial de um objeto Boolean, o novo objeto Boolean terá o valor de true.
var myFalse = new Boolean(false); // valor inicial false var g = new Boolean(myFalse); // valor inicial true var myString = new String("Hello"); // objeto String var s = new Boolean(myString); // valor inicial true Não use um um objeto Boolean no lugar de um primitivo Boolean.
Propriedades
Boolean.length-
Propriedade Length cujo valor é 1.
Boolean.prototype-
Representa o protótipo para o construtor
Boolean.
Métodos
O objeto global Boolean contém métodos próprios, entretanto, ele herda alguns métodos através da cadeia de protótipos:
Instâncias Boolean
Todas instâncias Boolean herdam de Boolean.prototype. Assim como todos os construtores, o protótipo do objeto dita as propriedades e métodos herdados.
Propriedades
Métodos
Exemplos
>Criando objetos Boolean com um valor inicial false
var bNoParam = new Boolean(); var bZero = new Boolean(0); var bNull = new Boolean(null); var bEmptyString = new Boolean(""); var bfalse = new Boolean(false); Criando objetos Boolean com um valor inicial true
var btrue = new Boolean(true); var btrueString = new Boolean("true"); var bfalseString = new Boolean("false"); var bSuLin = new Boolean("Su Lin"); var bArrayProto = new Boolean([]); var bObjProto = new Boolean({}); Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-boolean-objects> |