name 属性
返回一个名称,该名称属于一个错误。
errorObj.name
实参
- errorObj
必选。 Error 对象的实例。
备注
name 属性返回错误名或异常类型。 当发生运行时错误时,名称属性将被设置为下列本机异常类型之一:
异常类型 |
含义 |
---|---|
Error |
此错误是一个用户定义的错误,是使用 Error 对象构造函数创建的。 |
ConversionError |
每当尝试对一个对象进行它所无法完成的转换时,将发生此错误。 |
RangeError |
当给一个函数提供一个超过其允许范围的参数时,将发生此错误。 例如,当尝试构造的 Array 对象的长度不是有效的正整数时,发生此错误。 |
ReferenceError |
当检测到无效引用时,将发生此错误。 例如,如果所需的引用为 null,将发生此错误。 |
RegExpError |
当正则表达式产生编译错误时,将发生此错误。 然而,一旦该正则表达式经过了编译,就不会发生此错误。 例如,如果声明正则表达式的模式使用了无效的语法或使用了 i、g 或 m 以外的标志,或者多次包含同一个标志,将发生此错误。 |
SyntaxError |
当分析源文本后发现它不遵循正确的语法时,将发生此错误。 例如,当调用 eval 函数的参数不是有效的程序文本时,将发生此错误。 |
TypeError |
当操作数的实际类型与所期望的类型不符时,将发生此错误。 例如,如果在不是对象的内容上进行函数调用或者该内容不支持该调用时,发生此错误。 |
URIError |
当检测到非法的统一资源标识符 (URI) 时,将发生此错误。 例如,在正编码或解码的字符串中发现非法字符时,发生此错误。 |
示例
下面的示例导致引发异常并显示错误以及错误描述。
try
{
var arr = new Array(-1);
}
catch(e)
{
print ("Error Message: " + e.message);
print ("Error Code: " + (e.number & 0xFFFF))
print ("Error Name: " + e.name);
}
此代码的输出如下所示。
Error Message: Array length must be zero or a positive integer
Error Code: 5029
Error Name: RangeError