Error.isError()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Die statische Methode Error.isError() bestimmt, ob der übergebene Wert ein Error ist.

In diesem Artikel

Syntax

Error.isError(value)

Rückgabewert

true, wenn value ein Error ist; andernfalls false.

Error.isError() überprüft, ob der übergebene Wert ein Error ist. Dies erfolgt durch einen gebrandeten Check für ein privates Feld, das durch den Error()-Konstruktor initialisiert wurde. Dies ist derselbe Mechanismus, der von Array.isArray() verwendet wird, welcher wiederum dem Mechanismus ähnlich ist, der vom in-Operator verwendet wird.

Es ist eine robustere Alternative zu instanceof Error, da es falsche Positiv- und Negativmeldungen vermeidet:

Error.isError() lehnt Werte ab, die keine tatsächlichen Error-Instanzen sind, selbst wenn sie Error.prototype in ihrer Prototypenkette haben — instanceof Error würde diese akzeptieren, da es die Prototypenkette überprüft.
Error.isError() akzeptiert Error-Objekte, die in einem anderen Realm konstruiert wurden — instanceof Error gibt false aus, da die Identität des Error-Konstruktors zwischen Realms unterschiedlich ist.

Error.isError() gibt true für DOMException-Instanzen zurück. Dies liegt daran, dass DOMException, obwohl es nicht als echte Unterklasse von Error spezifiziert ist (der Error-Konstruktor ist nicht der Prototyp des DOMException-Konstruktors), für alle gebrandeten Prüfzwecke immer noch wie Error funktioniert.

Beispiele

Verwendung von Error.isError()

js
// all following calls return true
Error.isError(new Error());
Error.isError(new TypeError());
Error.isError(new DOMException());
try {
  1 + 1n;
} catch (e) {
  console.log(Error.isError(e)); // The operation threw a TypeError, so this returns true
}

// all following calls return false
Error.isError();
Error.isError({});
Error.isError(null);
Error.isError(undefined);
Error.isError(17);
Error.isError("Error");
Error.isError(true);
Error.isError(false);
// This is not an error, because the object does not have the private field
// initialized by the Error constructor
Error.isError({ __proto__: Error.prototype });

instanceof vs. Error.isError()

Wenn eine Error-Instanz überprüft wird, ist Error.isError() gegenüber instanceof vorzuziehen, da es über Realms hinweg funktioniert.

js
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

Normalisierung gefangener Fehler

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

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Error
Konstruktor
1. Error()
Statische Methoden
1. captureStackTrace()
2. isError()
Statische Eigenschaften
1. stackTraceLimit
Instanzmethoden
1. toString()
Instanzeigenschaften
1. cause
2. columnNumber
3. fileName
4. lineNumber
5. message
6. name
7. stack
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError

Error.isError()

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beschreibung

Beispiele

Verwendung von Error.isError()

instanceof vs. Error.isError()

Normalisierung gefangener Fehler

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN