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> |
Compatibilidade com navegadores
Loading…