name 属性 (Error)
返回错误的名称。
语法
errorObj.name
参数
errorObj
必要参数。Error对象的实例。
备注
name属性返回错误的名称或异常类型。当发生运行时错误时,名称属性将被设置为下列本机异常类型之一:
Exception Type | 意义 |
---|---|
ConversionError | 每当尝试对一个对象进行它所无法完成的转换时,将发生此错误。 |
RangeError | 当给一个函数提供一个超过其允许范围的参数时,将发生此错误。例如,当尝试构造Array对象的长度不是有效的正整数时,发生此错误。 |
ReferenceError | 如果检测到无效引用,则出现此错误。例如,如果所需的引用为null,将发生此错误。 |
RegExpError | 当正则表达式产生编译错误时,将发生此错误。然而,一旦该正则表达式经过了编译,就不会发生此错误。例如,如果声明正则表达式的模式使用了无效的语法或使用了i、g或m以外的标志,或者多次包含同一个标志,将发生此错误。 |
SyntaxError | 当分析源文本后发现它不遵循正确的语法时,将发生此错误。例如,当调用eval函数的参数不是有效的程序文本时,将发生此错误。 |
TypeError | 当操作数的实际类型与所期望的类型不符时,将发生此错误。例如,如果在不同对象的内容上进行函数调用或者该内容不支持该调用时,发生此错误。 |
URIError | 在检测到非法的统一资源标识符(URI)时,会出现此错误。例如,在正在编码或解码的字符串中发现非法字符时,发生此错误。 |
示例
下面的示例导致引发了TypeError异常,并显示了错误名称及其消息。
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); }
示例
此代码的输出如下所示。
Error Message: 'y' is undefined Error Code: 5009 Error Name: TypeError
必备条件
在以下文档模式中受支持:怪异模式、Internet Explorer 6标准模式、Internet Explorer 7标准模式、Internet Explorer 8标准模式、Internet Explorer 9标准模式、Internet Explorer 10标准模式、Internet Explorer 11标准模式。应用商店应用(Windows 8和Windows Phone 8.1)中也受支持。请参阅版本信息。
Applies To: Error Object