Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
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 objetoBoolean é um objeto wrapper para um valor booleano.
In this article
Sintaxe
new Boolean([value])
Parâmetros
valueOpcional. 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 defalse. Todos outros valores, incluindo qualquer objeto ou string"false", criam um objeto com valor inicialtrue.
Não confunda os valores primitivos Booleantrue efalse com os valorestrue andfalse do objetoBoolean.
Qualquer objeto cujo o valor não éundefined ounull, incluindo um objetoBoolean que o valor sejafalse, é avaliado paratrue quando passa por uma declaração condicional. Por exemplo, a condição a seguirif a declaração é avaliada comotrue:
var x = new Boolean(false);if (x) { // esse código é executado}Esse comportamento não se aplica aos primitivosBoolean. Por exemplo, a condição a seguirif a declaração é avaliada comofalse:
var x = false;if (x) { // esse código não é executado}Não use um objetoBoolean para converter um valor não-boleano para um valor boleano. Ao invés disso useBoolean como uma função para executar essa tarefa:
var x = Boolean(expression); // preferidovar x = new Boolean(expression); // não useSe você especificar qualquer objeto, incluindo um objetoBoolean cujo valor éfalse, como valor inicial de um objetoBoolean, o novo objetoBoolean terá o valor detrue.
var myFalse = new Boolean(false); // valor inicial falsevar g = new Boolean(myFalse); // valor inicial truevar myString = new String("Hello"); // objeto Stringvar s = new Boolean(myString); // valor inicial trueNão use um um objetoBoolean no lugar de um primitivoBoolean.
Propriedades
Boolean.lengthPropriedade Length cujo valor é 1.
Boolean.prototypeRepresenta o protótipo para o construtor
Boolean.
Métodos
O objeto globalBoolean contém métodos próprios, entretanto, ele herda alguns métodos através da cadeia de protótipos:
InstânciasBoolean
Todas instânciasBoolean herdam deBoolean.prototype. Assim como todos os construtores, o protótipo do objeto dita as propriedades e métodos herdados.
Propriedades
Métodos
Exemplos
>Criando objetosBoolean com um valor inicialfalse
var bNoParam = new Boolean();var bZero = new Boolean(0);var bNull = new Boolean(null);var bEmptyString = new Boolean("");var bfalse = new Boolean(false);Criando objetosBoolean com um valor inicialtrue
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> |