Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

TypeError

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

>

Das TypeError-Objekt repräsentiert einen Fehler, wenn eine Operation nicht ausgeführt werden konnte, typischerweise (aber nicht ausschließlich), wenn ein Wert nicht vom erwarteten Typ ist.

Ein TypeError kann ausgelöst werden, wenn:

  • ein Operand oder ein Argument, das an eine Funktion übergeben wird, nicht mit dem von diesem Operator oder dieser Funktion erwarteten Typ kompatibel ist; oder
  • wenn versucht wird, einen Wert zu ändern, der nicht geändert werden kann; oder
  • wenn versucht wird, einen Wert auf unangemessene Weise zu verwenden.

TypeError ist ein serialisierbares Objekt, sodass es mit structuredClone() geklont oder zwischen Arbeitern mit postMessage() kopiert werden kann.

TypeError ist eine Unterklasse von Error.

Konstruktor

TypeError()

Erstellt ein neues TypeError-Objekt.

Instanzeigenschaften

Erbaut auch Instanzeigenschaften von seinem übergeordneten Objekt Error.

Diese Eigenschaften sind auf TypeError.prototype definiert und werden von allen TypeError-Instanzen geteilt.

TypeError.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für TypeError-Instanzen ist der Anfangswert der TypeError-Konstruktor.

TypeError.prototype.name

Repräsentiert den Namen des Fehlertyps. Für TypeError.prototype.name ist der Anfangswert "TypeError".

Instanzmethoden

Erbt Instanzmethoden von seinem übergeordneten Objekt Error.

Beispiele

>

Abfangen eines TypeError

js
try {
  null.f();
} catch (e) {
  console.log(e instanceof TypeError); // true
  console.log(e.message); // "null has no properties"
  console.log(e.name); // "TypeError"
  console.log(e.stack); // Stack of the error
}

Erstellen eines TypeError

js
try {
  throw new TypeError("Hello");
} catch (e) {
  console.log(e instanceof TypeError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "TypeError"
  console.log(e.stack); // Stack of the error
}

Spezifikationen

Spezifikation
ECMAScript® 2026 Language Specification>
# sec-native-error-types-used-in-this-standard-typeerror>

Browser-Kompatibilität

Siehe auch