CKTIS / JavaScript
TypeError — ein Fehler bei unzulässigen Operationen
TypeError ist ein integrierter JavaScript-Fehlertyp und weist häufig auf eine Operation hin, die mit dem Typ eines Werts nicht vereinbar ist. Sie können ihn abfangen oder bei der Prüfung von Funktionsargumenten ausdrücklich auslösen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new TypeError(message)
TypeError(message)
throw new TypeError(message)TypeError ist ein integrierter Konstruktor für Fehler, die von Error erben, und keine Web-API-Schnittstelle. Er signalisiert häufig eine Operation, die ein Wert nicht unterstützt, etwa den Aufruf eines Werts, der keine Funktion ist. Die Spezifikation verwendet ihn auch dann, wenn kein anderer integrierter Fehlertyp den Fehler passend beschreibt.
Bei erfolgreicher Ausführung geben sowohl new TypeError(message) als auch der Aufruf TypeError(message) ohne new ein neues Fehlerobjekt zurück, statt es als Ausnahme auszulösen. Mit throw können Sie das erzeugte Objekt ausdrücklich als Ausnahme auslösen. Das Argument message ist optional, doch bei seiner Umwandlung in eine Zeichenkette kann eine Ausnahme auftreten, bevor ein Fehlerobjekt zurückgegeben wird. So löst new TypeError(Symbol()) auch ohne ausdrückliche throw-Anweisung einen TypeError aus.
Eigene Funktionen können TypeError auslösen, wenn ein Argument eine Typanforderung nicht erfüllt. Bei einem Wert des richtigen Typs, der aber außerhalb des zulässigen Bereichs liegt, ist gewöhnlich RangeError geeigneter. Im Beispiel fängt catch den erwarteten Fehler ab und löst andere Fehler erneut aus.
Richten Sie Ihre Logik nicht auf den genauen Wortlaut von Meldungen aus, die von der JavaScript-Engine erzeugt werden: Dieser ist nicht standardisiert. Das Beispiel gibt eine eigene Meldung an, daher ist die erwartete Ausgabe stabil. Eine Prüfung mit instanceof TypeError ist innerhalb derselben Realm-Umgebung geeignet, kann aber bei Fehlern aus einer anderen Umgebung, etwa einem separaten iframe, fehlschlagen.
Beispiele
function shout(value) {
if (typeof value !== "string") {
throw new TypeError("Expected a string");
}
return value.toUpperCase();
}
try {
shout(42);
} catch (error) {
if (!(error instanceof TypeError)) {
throw error;
}
console.log(error.name + ": " + error.message);
}Ergebnis
TypeError: Expected a string
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.