name 屬性

發行項
08/21/2008

更新：2007 年 11 月

傳回錯誤的名稱。

 errorObj.name

引數

errorObj
必要項。Error 物件的執行個體。

備註

name 屬性會傳回錯誤的名稱或例外狀況類型。發生執行階段錯誤時，屬性會設成下列原生例外狀況類型之一：

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

本程式碼的輸出為：