Boolean - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

Português (do Brasil)

Remember language Learn more

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.

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.

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({});

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 21 de nov. de 2024 by MDN contributors.

View this page on GitHub • Report a problem with this content

Objetos Globais
Boolean
Construtor
1. Boolean()
Métodos de instância
1. Boolean.prototype.toString()
2. Boolean.prototype.valueOf()
Herança
Object/Function
Métodos estáticos
Propriedades estáticas
Métodos de instância
Propriedades de instância
1. Object.prototype.__proto__
2. Object.prototype.constructor

Boolean

In this article

Sintaxe

Parâmetros

Descrição

Propriedades

Métodos

Instâncias Boolean

Propriedades

Métodos

Exemplos

Criando objetos Boolean com um valor inicial false

Criando objetos Boolean com um valor inicial true

Especificações

Compatibilidade com navegadores

Veja também

Help improve MDN