Error
Der Error
Konstruktor erstellt ein Fehler (Error) Objekt. Instanzen von Error
Objekten werden geworfen (thrown), wenn zur Laufzeit ein Fehler auftritt. Das Error
Objekt kann zudem als Basis für benutzerdefinierte Fehler benutzt werden. Weiter unten werden schon eingebaute Fehlertypen beschrieben.
Syntax
new Error([message[, fileName[, lineNumber]]])
Parameter
message
- Optional. Für Menschen lesbare Beschreibung des Errors.
fileName
Non-Standard- Optional. Der Wert für die
fileName
Eigenschaft eines erstelltenError
Objekts. Der Standardwert ist der Name der Datei, in dem der QuelltextError()
aufgerufen wird. lineNumber
Non-Standard- Optional. Der Wert für die
lineNumber
Eigenschaft eines erstelltenError
Objekts. Der Standardwert ist die Zeilennummer, in dem der QuelltextError()
aufgerufen wird.
Beschreibung
Laufzeitfehler resultieren in einem neu erstellten und geworfenen Error
Objekt.
Diese Seite Dokumentiert den Einsatz des Error
Objektes und den Einsatz als Konstruktorfunktion. Für eine Liste der Eigenschaften und Methoden, die eine Error
Instanz erbt, siehe auf der Seite Error.prototype
(en-US).
Einsatz als Funktion
Wenn Error
als Funktion genutzt wird -- ohne new
, wird diese ein Error
Objekt zurückgeben. Daher wird der Aufruf der Funktion das gleiche zurückgeben wie der Aufruf des Error
Konstruktors (mit new
Schlüsselwort).
// dieser Aufruf:
const x = Error('Ich wurde mit einem Funktionsaufruf erstellt!');
// hat die gleiche Funktion wie folgender:
const y = new Error('Ich wurde mit dem "new" Schlüsselwort erstellt!');
Fehlertypen
Neben dem generischen Error
Konstruktor sind in JavaScript noch sieben weitere Error-Konstruktoren eingebaut. Für benutzerdefinierte Fehler siehe Statements zur Fehler- und Ausnahmebehandlung.
EvalError
- Erstellt eine Instanz, die einen Fehler repräsentiert, der bei der globalen
eval()
(en-US) Funktion auftritt. InternalError
Non-Standard- Erstellt eine Instanz, die einen Fehler repräsentiert, der auftritt, wenn ein interner Fehler in JavaScript auftaucht (z. B. zu viel Rekursion).
RangeError
- Erstellt eine Instanz, die einen Fehler repräsentiert, der auftritt, wenn eine nummerische Variable oder ein nummerischer Parameter außerhalb seiner validen Grenzen ist.
ReferenceError
- Erstellt eine Instanz, die einen Fehler repräsentiert, der auftritt, wenn eine nicht valide Referenz referenziert werden soll.
SyntaxError
- Erstellt eine Instanz, die einen Fehler repräsentiert, der auftritt, wenn die Syntax von Quellcode, der in der
eval()
(en-US) Funktion übergeben wird, nicht richtig ist. TypeError
- Erstellt eine Instanz, die einen Fehler repräsentiert, der auftritt, wenn eine Variable oder ein Parameter einen nicht validen Typen enthält.
URIError
- Erstellt ein Instanz, die einen Fehler repräsentiert, der auftritt, wenn die Methode
encodeURI()
oderdecodeURI()
(en-US) nicht valide Parameter übergeben bekommt.
Eigenschaften
Error.prototype
(en-US)- Erlaubt es die Eigenschaften aller
Error
Instanzen zu verändern.
Methoden
Das globale Error
Objekt besitzt keine eigenen Methoden. Stattdessen erbt es einige Methoden durch die Prototypenkette.
Error Instanzen
Eigenschaften
Methoden
Beispiele
Werfen eines generischen Errors
Typischerweise erstellt man ein Error
Objekt mit der Intention es mit dem throw
Schlüsselwort zu werfen. Man kann den Fehler auffangen, indem man ein try...catch
Konstrukt benutzt.
try {
throw new Error('Whoops!');
} catch (e) {
console.log(e.name + ': ' + e.message);
}
Einen Spezifischen Error behandeln
Man kann sich aussuchen, welche spezifischen Fehlertypen behandelt werden sollen, indem man die constructor
Eigenschaft des Errors abfragt. In modernen JavaScript-Umgebungen kann stattdessen das instanceof
Schlüsselwort verwendet werden:
try {
foo.bar();
} catch (e) {
if (e instanceof EvalError) {
console.log(e.name + ': ' + e.message);
} else if (e instanceof RangeError) {
console.log(e.name + ': ' + e.message);
}
// ... etc
}
Benutzerdefinierte Fehlertypen
Manchmal möchte man aber einen eigenen Error erstellen, der von Error
abgeleitet ist, durch den Aufruf throw new CustomError()
geworfen werden kann und durch instanceof CustomError
abgefragt werden kann. Eigene Fehlertypen führen zu einer besseren und konsistenten Fehlerbehandlung. Für eine tiefer gehende Diskussion schaue bitte auf Stack Overflow nach.
ES6 benutzerdefinierte Error Klasse
Babel und andere Transpiler werden den folgenden Quelltext nicht ohne zusätzliche Konfigurationen verarbeiten können.
Einige Browser enthalten den CustomError Konstruktor im Stack Trace, wenn ES2015 Klassen eingesetzt werden
class CustomError extends Error {
constructor(foo = 'bar', ...params) {
// Übergibt die verbleibenden Parameter (einschließlich Vendor spezifischer Parameter) dem Error Konstruktor
super(...params);
// Behält den richtigen Stack-Trace für die Stelle bei, an der unser Fehler ausgelöst wurde (nur bei V8 verfügbar)
if (Error.captureStackTrace) {
Error.captureStackTrace(this, CustomError);
}
// Benutzerdefinierte Debugging Informationen
this.foo = foo;
this.date = new Date();
}
}
try {
throw new CustomError('buz', 'buzMessage');
} catch(e){
console.log(e.foo); // baz
console.log(e.message); // bazMessage
console.log(e.stack); // stacktrace
}
ES5 benutzerdefiniertes Error Objekt
Alle Browser enthalten den CustomError Konstruktor im Stack Trace, wenn eine Prototypische Deklaration verwendet wird.
function CustomError(foo, message, fileName, lineNumber) {
var instance = new Error(message, fileName, lineNumber);
instance.foo = foo;
Object.setPropertyOf(instance, Object.getPrototypeOf(this));
if(Error.captureStackTrace) {
Error.captureStackTrace(instance, CustomError);
}
return instance;
}
CustomError.prototype = Object.create(Error.prototype, {
constructor: {
value: Error,
enumerable: false,
writable: true,
configurable: true
}
});
if(typeof Object.setPropertyOf != 'undefined') {
Object.setPrototypeOf(CustomError, Error);
} else {
CustomError.__proto__ = Error;
}
try {
throw new CustomError('baz', 'bazMessage');
} catch (e) {
console.log(e.foo); // 'baz'
console.log(e.message); // 'bazMessage'
}
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initiale Definition. Implementiert in JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) Die Definition von 'Error' in dieser Spezifikation. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Error' in dieser Spezifikation. |
Standard | |
ECMAScript (ECMA-262) Die Definition von 'Error' in dieser Spezifikation. |
Lebender Standard |
Browserkompatibilität
BCD tables only load in the browser