object.addConst()

Add a hidden, read-only data property to any object...

Syntax

obj.addConst(key, value);

Parameters

Parameter	Type	Mandatory	Description	Util.js version

Parameter	Type	Mandatory	Description	Util.js version
key	String		The name (key) of the property.	1.0
value	Variant		The value associated with the property.	1.0

Return value

Value	Type	Notes	API Version

Value

Type

Notes

API Version

<object>

Object

If successful, the addProp() method returns the modified object.

1.0

<error>

TypeError

An error will be thrown if:

The parameters are invalid, or
The object is not extensible, or
The key being modified is non-configurable.

1.0

Example

Adding a property to an object...

myObj = {};
 
myObj.addConst("foo", "bar");
 
myObj.foo; // "bar"
 
myObj.foo = "moo"; // does nothing, foo is read-only
 
myObj.foo // "bar"
 
for (i in myObj) {
	// does not iterate foo (foo is hidden)
}