Error-Objekt
Enthält Informationen über Fehler. Der Error-Konstruktor liegt in zwei Formen vor.
function Error([description : String ])
function Error([number : Number [, description : String ]])
Argumente
number
Optional. Ein dem Fehler zugewiesener numerischer Wert, der den Wert der number-Eigenschaft angibt. Null (0), falls das Argument weggelassen wird.description
Optional. Kurze Zeichenfolge, die den Fehler beschreibt und den Startwert der description-Eigenschaft und der message-Eigenschaft angibt. Eine leere Zeichenfolge, falls das Argument weggelassen wird.
Hinweise
Error-Objekte können mithilfe des oben angegebenen Konstruktors explizit erstellt werden. Sie können dem Error-Objekt Eigenschaften hinzufügen, um seine Funktionen zu erweitern. Ein Error-Objekt wird außerdem jedes Mal erstellt, wenn ein Laufzeitfehler auftritt, um den Fehler zu beschreiben.
Typischerweise wird ein Error-Objekt durch die throw-Anweisung ausgelöst, mit der Erwartung, dass es von einer try...catch-Anweisung abgefangen wird. Mit einer throw-Anweisung können Sie jeden beliebigen Datentyp als Fehler übergeben. Die throw-Anweisung erstellt nicht implizit ein Error-Objekt. Wenn jedoch ein Error-Objekt ausgelöst wird, können JScript-Laufzeitfehler und benutzerdefinierte Fehler auf ähnliche Weise von einem catch-Block behandelt werden.
Das Error-Objekt verfügt über vier integrierte Eigenschaften: die Beschreibung des Fehlers (description-Eigenschaft und message-Eigenschaft), die Fehlernummer (number-Eigenschaft) und den Namen des Fehlers (name-Eigenschaft). Die description-Eigenschaft und die message-Eigenschaft beziehen sich auf dieselbe Meldung. Die description-Eigenschaft ermöglicht Abwärtskompatibilität. Die message-Eigenschaft entspricht hingegen dem ECMA-Standard.
Eine Fehlernummer ist ein 32-Bit-Wert. Das obere 16-Bit-Wort ist der Teildienstcode, während das untere Wort den eigentlichen Fehlercode darstellt. Um den tatsächlichen Fehlercode abzulesen, kombinieren Sie die number-Eigenschaft mit dem Operator & (bitweiser Operator And) mit der Hexadezimalzahl 0xFFFF.
Warnung
Wenn Sie das Error-Objekt von JScript in einer ASP.NET-Seite verwenden, kann dies zu unbeabsichtigten Ergebnissen führen. Dies liegt an der möglichen Mehrdeutigkeit zwischen dem Error-Objekt von JScript und dem Error-Ereignis der ASP.NET-Seite. Verwenden Sie für die Fehlerbehandlung in ASP.NET-Seiten anstelle des Error-Objekts die System.Exception-Klasse.
Tipp
Das Error-Objekt wird nur von JScript bereitgestellt. Da dieses nicht von einem .NET Framework-Typ abgeleitet wird, kann es von anderen CLS (Common Language Specification-)Sprachen nicht verwendet werden. Achten Sie daher beim Ausstatten der Parameter und Rückgabetypen von CLS‑kompatiblen Methoden mit Typanmerkungen darauf, dass Sie den System.Exception-Datentyp verwenden und nicht das Error-Objekt. Sie können das Error-Objekt jedoch verwenden, um andere Bezeichner als Parameter oder Rückgabetypen mit Typanmerkungen zu versehen. Weitere Informationen hierzu finden Sie unter Schreiben von CLS-kompatiblem Code.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung des Error-Objekts.
try {
// Throw an error.
throw new Error(42,"No question");
} catch(e) {
print(e)
// Extract the error code from the error number.
print(e.number & 0xFFFF)
print(e.description)
}
Ausgabe dieses Codes:
Error: No question
42
No question
Eigenschaften und Methoden
Eigenschaften und Methoden des Error-Objekts