name 屬性
傳回錯誤的名稱。
errorObj.name
引數
- errorObj
必要項。 Error 物件的執行個體。
備註
name 屬性會傳回錯誤的名稱或例外狀況類型。 發生執行階段錯誤時，屬性會設成下列原生例外狀況類型之一：
例外狀況類型 |
意義 |
|---|---|
錯誤 |
本項錯誤是一個使用者定義的錯誤，可用 Error 物件建構函式建立。 |
ConversionError |
試圖將物件轉換成無法轉換的型別時，就會發生這個錯誤。 |
RangeError |
提供給函式的引數超出允許的範圍時，就會發生這個錯誤。 例如，建構 Array 物件時，若試圖使用不是有效的正整數長度，就會發生這個錯誤。 |
ReferenceError |
偵測到無效參考時，就會發生這個錯誤。 例如，如果預期的參考是 null，就會發生這個錯誤。 |
RegExpError |
規則運算式發生編譯錯誤時，就會發生這個錯誤。 然而，規則運算式一旦經過編譯後，就不可能發生這個錯誤。 例如，如果宣告規則運算式所用的模式語法無效，或旗標不是 i、g 或 m，或同一個旗標出現不止一次，就會發生這樣的例子。 |
SyntaxError |
剖析原始碼文字，而該原始碼文字不符合正確語法時，就會發生這個錯誤。 例如，如果呼叫 eval 函式時所用的引數不是有效的程式文字，就會發生這樣的錯誤。 |
TypeError |
只要運算元實際的型別不符合預期型別時，就會發生這個錯誤。 例如，如果對非物件的東西呼叫函式，或這個東西不支援該呼叫，就會發生這樣的例子。 |
URIError |
偵測到非法的 Uniform Resource Indicator (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