Flylib.com

Books Software

 
 
 

Section 24.184. TypeError: thrown when a value is of the wrong type


24.184. TypeError: thrown when a value is of the wrong type

ECMAScript v3: Object Error TypeError

24.184.1. Constructor

new TypeError( )
new TypeError(


message


)

24.184.1.1. Arguments


message

An optional error message that provides details about the exception. If specified, this argument is used as the value for the message property of the TypeError object.

24.184.1.2. Returns

A newly constructed TypeError object. If the message argument is specified, the Error object uses it as the value of its message property; otherwise , it uses an implementation-defined default string as the value of that property. When the TypeError( ) constructor is called as a function, without the new operator, it behaves just as it does when called with the new operator.

24.184.2. Properties



message

An error message that provides details about the exception. This property holds the string passed to the constructor, or an implementation-defined default string. See Error.message for details.



name

A string that specifies the type of the exception. All TypeError objects inherit the value "TypeError" for this property.

24.184.3. Description

An instance of the TypeError class is thrown when a value is not of the type expected. This happens most often when you attempt to access a property of a null or undefined value. It can also occur if you invoke a method defined by one class on an object that is an instance of some other class, or if you use the new operator with a value that is not a constructor function, for example. JavaScript implementations are also permitted to throw TypeError objects when a built-in function or method is called with more arguments than expected. See Error for details about throwing and catching exceptions.

24.184.4. See Also

Error , Error.message , Error.name



24.185. undefined: the undefined value

ECMAScript v3

24.185.1. Synopsis

undefined

24.185.2. Description

undefined is a global property that holds the JavaScript undefined value. This is the same value that is returned when you attempt to read the value of a nonexistent object property. The undefined property is not enumerated by for/in loops and cannot be deleted with the delete operator. Note that undefined is not a constant and can be set to any other value, something that you should take care not to do.

When testing a value to see whether it is undefined, use the === operator, because the == operator treats the undefined value as equal to null .



24.186. unescape ( ): decode an escaped string

ECMAScript v1; deprecated in ECMAScript v3

24.186.1. Synopsis

unescape(


s


)

24.186.1.1. Arguments


s

The string that is to be decoded or "unescaped."

24.186.1.2. Returns

A decoded copy of s .

24.186.2. Description

unescape( ) is a global function that decodes a string encoded with escape( ) . It decodes s by finding and replacing character sequences of the form % xx and %u xxxx (where x represents a hexadecimal digit) with the Unicode characters \u00 xx and \ u xxxx .

Although unescape( ) was standardized in the first version of ECMAScript, it has been deprecated and removed from the standard by ECMAScript v3. Implementations of ECMAScript are likely to implement this function, but they are not required to. You should use decodeURI( ) and decodeURIComponent( ) instead of unescape( ) . See escape( ) for more details and an example.

24.186.3. See Also

decodeURI( ) , decodeURIComponent( ) , escape( ) , String