OBJECT: Boolean
new Boolean(value)
The Boolean object is an object wrapper for a Boolean value and is constructed with
the above Boolean constructor. If there is no initial value or it is 0, -0, null,
false, NaN, undefined or the empty string (""), the initial value is
false. Otherwise, even with the string "false", it is true. So, all the following
objects have an initial value of false:
x = new Boolean()
x = new Boolean(0)
x = new Boolean(-0)
x = new Boolean(null)
x = new Boolean(false)
x = new Boolean(NaN)
x = new Boolean(undefined)
x = new Boolean("")
...whereas in the following examples the Boolean object 'x' has an initial value of true:
myBool = new Boolean(false)
x = new Boolean(myBool)
x = new Boolean("false")
Any Boolean object that is passed to a conditional statement (except those with an initial
value of null or undefined) evaluates to true. So, for instance, the conditional
statement in the following code evaluates to true.
Code:
x = new Boolean(false)
if(x)
However, this does not apply to Boolean primitives, and the conditional statement in the following
code evaluates to false.
Code:
x = false
if(x)
NOTE:
In JavaScript 1.3 and later versions, don't use a Boolean object instead of a Boolean
primitive, nor should you use a Boolean object to convert a non-Boolean value to a Boolean
one. To do so use Boolean as a function. For example, the following converts
the expression 'a+b' to a Boolean value:
Code:
x = Boolean(a+b)
PROPERTIES
constructor property
This property specifies the function that created the object's prototype. See also the
Object.constructor property.
Syntax: object.constructor
prototype property
This property represents the prototype for this object and allows you to add methods
and properties of your own. See also the
Function.prototype property.
Syntax: object.prototype
METHODS
toSource method
This method, which is usually called internally by JavaScript, returns a string
representing the source code of the object. It overrides the
Object.toSource method.
Syntax: object.toSource()
toString method
This method converts a Boolean object to a string representing its value: i.e. either
"true" or "false", and is called by JavaScript automatically whenever a Boolean object
is used in a situation requiring a string. This method overrides the
Object.toString method.
Syntax: object.toString()
valueOf method
This method, which is usually called internally by JavaScript, returns a primitive value
(either "true" or "false") for the Boolean object. It overrides the
Object.valueOf method.
Syntax: object.valueOf()
NOTE:
The Boolean object also inherits the watch and
unwatch methods from the Object
object.
Copyright 1999 by Infinite Software Solutions, Inc.
Trademark Information