Referencia de JavaScript 1.5:Objetos globales:Boolean

De MDC

Tabla de contenidos 1 Resumen 2 Se crea con 3 Parámetros 4 Descripción 5 Compatibilidades 5.1 JavaScript 1.2 y versiones anteriores 6 Propiedades 7 Métodos 8 Ejemplos 8.1 Creando objetos Boolean con un valor inicial falso 8.2 Creando objetos Boolean con un valor inicial true

[editar] Resumen

Objeto del Núcleo

El objeto Boolean es un objeto envoltorio para un valor booleano (boolean).

[editar] Se crea con

El constructor Boolean:

new Boolean(valor)

[editar] Parámetros

valor 

El valor inicial del objeto Boolean. El valor es convertido a un valor boolean, si es necesario. Si se omite el valor o es 0, -0, null, false, NaN, undefined, o la cadena vacía (""), el objeto tiene un valor incial de false. Todos los demás valores, incluyendo cualquier objeto o la cadena "false", crea un objeto con el valor inicial de true.

[editar] Descripción

No se deben confundir los valores primitivos booleanos true y false con los valores true y false del objeto Boolean.

Cualquier objeto cuyo valor no sea undefined o null, incluyendo un objeto Boolean cuyo valor sea false, se evalua como true cuando se pasa a una sentencia condicional. Por ejemplo, la condición de la siguiente sentencia se evalúa como true:

x = new Boolean(false);
if (x) //the condition is true

Este comportamiento no se aplica a los valores primitivos booleanos. Por ejemplo, la condición de la siguiente sentencia se evalúa como false:

x = false;
if (x) //the condition is false

No use un objeto Boolean para convertir un valor no booleano a un valor booleano. En ese caso, utilice Boolean como una función para realizar esta tarea:

x = Boolean(expression);     //preferido
x = new Boolean(expression); //no usar

Si especifica cualquier objeto, incluyendo un objeto Boolean cuyo valor es false, como valor inicial del objeto Boolean, el nuevo objeto Boolean tiene un valor de true.

myFalse = new Boolean(false);   // initial value of false
g = new Boolean(myFalse);       //initial value of true
myString = new String("Hello"); // string object
s = new Boolean(myString);      //initial value of true

No usar un objeto Boolean en lugar de una primitiva booleana (true o false).

[editar] Compatibilidades

[editar] JavaScript 1.2 y versiones anteriores

El objeto Boolean se comporta como sigue:

• Cuando se usa un objeto Boolean como la condición de una sentencia condicional, JavaScript devuelve el valor del objeto Boolean. Por ejemplo, un objeto Boolean cuyo valor es false se trata como el valor primitive false, y un objeto Boolean cuyo valor es true se trata como el valor primitivo true en las sentencias condicionales. Si el objeto Boolean es un objeto false, la sentencia condicional se evalua como false.

• Puede usar el objeto Boolean en lugar de un valor primitivo booleano (true o false).

[editar] Propiedades

constructor: Especifica la función que crea un prototipo del objeto.

prototype: Define una propiedad que es compartida por todos los objetos Boolean.

[editar] Métodos

toSource: Devuelve un literal que representa el objeto Boolean especificado; puede usar este valor para crear un nuevo objeto. Sobreescribe el método Object.toSource.

toString: Devuelve una cadena que representa el objeto especificado. Sobreescribe el método Overrides the Object.toString.

valueOf: Devuelve el valor primitivo de un objeto Boolean. Sobreescribe el método Object.valueOf.

Además, este objeto hereda los métodos watch y unwatch de Object.

[editar] Ejemplos

[editar] Creando objetos Boolean con un valor inicial falso

bNoParam = new Boolean();
bZero = new Boolean(0);
bNull = new Boolean(null);
bEmptyString = new Boolean("");
bfalse = new Boolean(false);

[editar] Creando objetos Boolean con un valor inicial true

btrue = new Boolean(true);
btrueString = new Boolean("true");
bfalseString = new Boolean("false");
bSuLin = new Boolean("Su Lin");