name 属性

2008-08-18

更新：2007 年 11 月

返回一个名称，该名称属于一个错误。

errorObj.name

参数

errorObj
必选。Error 对象的实例。

备注

name 属性返回错误名或异常类型。当发生运行时错误时，名称属性将被设置为下列本机异常类型之一：

异常类型	含义
Error	此错误是一个用户定义的错误，是使用 Error 对象构造函数创建的。
ConversionError	每当试图对一个对象进行它所无法完成的转换时，将发生此错误。
RangeError	当给一个函数提供一个超过其允许范围的参数时，将发生此错误。例如，当试图构造的 Array 对象的长度不是有效的正整数时，发生此错误。
ReferenceError	当检测到无效引用时，将发生此错误。例如，如果所需的引用为 null，将发生此错误。
RegExpError	当正则表达式产生编译错误时，将发生此错误。然而，一旦该正则表达式经过了编译，就不会发生此错误。例如，如果声明正则表达式的模式使用了无效的语法或 i、g 或 m 以外的标志，或者多次包含同一个标志，将发生此错误。
SyntaxError	当分析源文本后发现它不遵循正确的语法时，将发生此错误。例如，当调用 eval 函数的参数不是有效的程序文本时，将发生此错误。
TypeError	当操作数的实际类型与所期望的类型不符时，将发生此错误。例如，如果在不是对象的内容上进行函数调用或者该内容不支持该调用时，发生此错误。
URIError	当检测到非法的统一资源标识符 (URI) 时，将发生此错误。例如，在正编码或解码的字符串中发现非法字符时，发生此错误。

示例

下面的示例导致引发了异常，并显示了错误和错误说明。

function getAge(age) {
   if(age < 0)
      throw new Error("An age cannot be negative.")
   print("Age is "+age+".");
}

// Pass the getAge an invalid argument.
try {
   getAge(-5);
} catch(e) {
   print(e.name);
   print(e.description);
}

该代码的输出为：