Error.isError()

value

Der zu überprüfende Wert.

true, wenn value ein Error ist; andernfalls false.

Error.isError() überprüft, ob der übergebene Wert ein Error ist. Dies geschieht durch eine Markenprüfung für eine private Eigenschaft, die vom Error()-Konstruktor initialisiert wird. Dies ist der gleiche Mechanismus, der von Array.isArray() verwendet wird, was wiederum dem Mechanismus ähnlich ist, der vom in-Operator verwendet wird.

Es ist eine robustere Alternative zu instanceof Error, da es falsche positive und falsche negative Ergebnisse vermeidet:

• Error.isError() lehnt Werte ab, die keine tatsächlichen Error-Instanzen sind, selbst wenn sie Error.prototype in ihrer Prototyp-Kette haben — instanceof Error würde diese akzeptieren, da es die Prototyp-Kette überprüft.
• Error.isError() akzeptiert Error-Objekte, die in einem anderen Bereich konstruiert wurden — instanceof Error gibt für diese false zurück, da die Identität des Error-Konstruktors zwischen den Bereichen unterschiedlich ist.

Error.isError() gibt true für DOMException Instanzen zurück. Dies liegt daran, dass, obwohl DOMException nicht als echte Unterklasse von Error spezifiziert ist (der Error-Konstruktor nicht der Prototyp des DOMException-Konstruktors ist), DOMException sich dennoch für alle Markenprüfungszwecke wie Error verhält.

Beim Überprüfen auf Error-Instanz wird Error.isError() gegenüber instanceof bevorzugt, da es bereichsübergreifend funktioniert.

const iframe = document.createElement("iframe");
document.body.appendChild(iframe);
const xError = window.frames[window.frames.length - 1].Error;
const error = new xError();

// Correctly checking for Error
Error.isERror(error); // true
// The prototype of error is xError.prototype, which is a
// different object from Error.prototype
error instanceof Error; // false

Sie können Error.isError() verwenden, um zu erkennen, ob der abgefangene Wert ein Fehler ist und ihn in ein Fehlerobjekt zu normalisieren.

try {
  throw "Oops; this is not an Error object";
} catch (e) {
  if (!Error.isError(e)) {
    e = new Error(e);
  }
  console.error(e.message);
}

• Polyfill von Error.isError in core-js
• Error