name Property (Windows Scripting - JScript)

Article
07/17/2015

Returns the name of an error.

Syntax

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
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.

The following example causes a TypeError exception to be thrown and displays the name of the error and its message.

try
{
    var x = y;
}
catch(e)
{
    document.write ("Error Message: " + e.message);
    document.write ("<br />");
    document.write ("Error Code: ");
    document.write (e.number & 0xFFFF)
    document.write ("<br />");
    document.write ("Error Name: " + e.name);
}

The output of this code is as follows.

Error Message: 'y' is undefined
Error Code: 5009
Error Name: TypeError

Requirements

Version 5.5

Applies To: Error Object (Windows Scripting - JScript)

Change History

Date	History	Reason
March 2009	Modified example.	Information enhancement.

March 2009

Modified example.

Information enhancement.

Partager via