SuppressedError
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das SuppressedError-Objekt repräsentiert einen Fehler, der während der Behandlung eines anderen Fehlers erzeugt wurde. Es wird bei der Freigabe von Ressourcen mittels using oder await using erzeugt.
Im Vergleich zu AggregateError wird SuppressedError verwendet, um einen einzelnen Fehler darzustellen, der durch einen anderen Fehler unterdrückt wird, während AggregateError eine Liste von nicht zusammenhängenden Fehlern darstellt. Es ist jedoch möglich, dass ein SuppressedError eine Kette von unterdrückten Fehlern enthält (e.suppressed.suppressed.suppressed...). Es unterscheidet sich auch semantisch von cause, da der Fehler nicht durch einen anderen Fehler verursacht wird, sondern auftritt, wenn ein anderer Fehler gehandhabt wird.
SuppressedError ist eine Unterklasse von Error.
Konstruktor
SuppressedError()-
Erstellt ein neues
SuppressedError-Objekt.
Instanz-Eigenschaften
Erbt auch Instanz-Eigenschaften von seinem Elternteil Error.
Diese Eigenschaften sind auf SuppressedError.prototype definiert und werden von allen SuppressedError-Instanzen geteilt.
SuppressedError.prototype.constructor-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
SuppressedError-Instanzen ist der anfängliche Wert derSuppressedError-Konstruktor. SuppressedError.prototype.name-
Repräsentiert den Namen für den Fehlertyp. Für
SuppressedError.prototype.nameist der Anfangswert"SuppressedError".
Hinweis:
SuppressedError hat niemals die cause-Eigenschaft, da sich die Bedeutung von cause mit suppressed überschneidet.
Diese Eigenschaften sind eigene Eigenschaften jeder SuppressedError-Instanz.
error-
Ein Verweis auf den Fehler, der zur Unterdrückung führt.
suppressed-
Ein Verweis auf den Fehler, der durch
errorunterdrückt wird.
Instanz-Methoden
Erbt Instanz-Methoden von seinem Elternteil Error.
Beispiele
Abfangen eines SuppressedError
Ein SuppressedError wird ausgelöst, wenn während der Ressourcenfreigabe ein Fehler auftritt. Das Auslösen eines Fehlers bewirkt die Bereinigung des Geltungsbereichs, und jeder Disposer während der Bereinigung kann seinen eigenen Fehler auslösen. All diese Fehler werden in eine Kette von SuppressedError-Instanzen gesammelt, wobei der ursprüngliche Fehler als suppressed-Eigenschaft und der neue Fehler, der vom nächsten Disposer ausgelöst wird, als error-Eigenschaft fungiert.
try {
using resource1 = {
[Symbol.dispose]() {
throw new Error("Error while disposing resource1");
},
};
using resource2 = {
[Symbol.dispose]() {
throw new Error("Error while disposing resource2");
},
};
throw new Error("Original error");
} catch (e) {
console.log(e instanceof SuppressedError); // true
console.log(e.message); // "An error was suppressed during disposal"
console.log(e.name); // "SuppressedError"
console.log(e.error); // Error: Error while disposing resource1
console.log(e.suppressed); // SuppressedError: An error was suppressed during disposal
console.log(e.suppressed.error); // Error: Error while disposing resource2
console.log(e.suppressed.suppressed); // Error: Original error
}
Die Kette sieht so aus:
SuppressedError --suppressed--> SuppressedError --suppressed--> Original error
| |
error error
v v
Error while disposing resource1 Error while disposing resource2
(Disposal happens later) (Disposal happens earlier)
Erstellen eines SuppressedError
try {
throw new SuppressedError(
new Error("New error"),
new Error("Original error"),
"Hello",
);
} catch (e) {
console.log(e instanceof SuppressedError); // true
console.log(e.message); // "Hello"
console.log(e.name); // "SuppressedError"
console.log(e.error); // Error: "New error"
console.log(e.suppressed); // Error: "Original error"
}
Spezifikationen
| Specification |
|---|
| ECMAScript Async Explicit Resource Management # sec-suppressederror-objects |
Browser-Kompatibilität
Loading…