name Property

Article
11/16/2012

Returns the name of an error.

errorObj.name

Arguments

errorObj
Required. Instance of Error object.

Remarks

The name property returns the name or exception type of an error. When a runtime error occurs, the name property is set to one of the following native exception types:

Exception Type	Meaning
Error	This error is a user-defined error, created using the Error object constructor.
ConversionError	This error occurs whenever there is an attempt to convert an object into something to which it cannot be converted.
RangeError	This error occurs when a function is supplied with an argument that has exceeded its allowable range. For example, this error occurs if you attempt to construct an Array object with a length that is not a valid positive integer.
ReferenceError	This error occurs when an invalid reference has been detected. This error will occur, for example, if an expected reference is null.
RegExpError	This error occurs when a compilation error occurs with a regular expression. Once the regular expression is compiled, however, this error cannot occur. This example will occur, for example, when a regular expression is declared with a pattern that has an invalid syntax, or flags other than i, g, or m, or if it contains the same flag more than once.
SyntaxError	This error occurs when source text is parsed and that source text does not follow correct syntax. This error will occur, for example, if the eval function is called with an argument that is not valid program text.
TypeError	This error occurs whenever the actual type of an operand does not match the expected type. An example of when this error occurs is a function call made on something that is not an object or does not support the call.
URIError	This error occurs when an illegal Uniform Resource Indicator (URI) is detected. For example, this is error occurs when an illegal character is found in a string being encoded or decoded.

Example

The following example causes an exception to be thrown and displays the error and a description of the error.

try
{
    var arr = new Array(-1);
}
catch(e)
{
    print ("Error Message: " + e.message);
    print ("Error Code: " + (e.number & 0xFFFF))
    print ("Error Name: " + e.name);
}

The output of this code is as follows.

Error Message: Array length must be zero or a positive integer
Error Code: 5029
Error Name: RangeError

Requirements

Version 5.5

Applies To:

Error Object

Change History

Date	History	Reason
July 2009	Modified example.	Content bug fix.
March 2009	Modified example.	Information enhancement.