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:

js
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:

js
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:

js
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.

js
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

js
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

js
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

Veja também