Boolean
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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 Language Specification # sec-boolean-objects |
Compatibilidade com navegadores
BCD tables only load in the browser