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