ReadableByteStreamController: Methode error()
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die error()
-Methode der ReadableByteStreamController
-Schnittstelle verursacht, dass alle zukünftigen Interaktionen mit dem zugehörigen Stream mit dem angegebenen Grund fehlschlagen.
Diese Methode wird häufig von einer zugrunde liegenden Quelle aufgerufen, um einen Fehler aus der Schnittstelle zu melden, von der sie ihre Daten bezieht (z. B. ein Lese- oder Socketfehler). Sie kann auch von anderen Stellen aus aufgerufen werden, um einen Streamfehler auszulösen, beispielsweise wenn ein anderer Teil des Systems, auf den der Stream angewiesen ist, ausfällt.
Syntax
error(errorObject)
Parameter
errorObject
-
Jedes Objekt, mit dem zukünftige Interaktionen fehlschlagen sollen.
Rückgabewert
Keiner (undefined
).
Ausnahmen
TypeError
-
Wird ausgelöst, wenn das Quellobjekt kein
ReadableByteStreamController
ist oder der Stream aus einem anderen Grund nicht lesbar ist.
Beispiele
Das Beispiel in Verwendung von lesbaren Bytestreams > Erstellen eines lesbaren Socket-Push-Bytestreams zeigt, wie Sie error()
verwenden könnten, um einen Streamfehler manuell auszulösen, wenn ein anderer Teil des Systems, auf das es angewiesen ist, ausfällt.
Speziell ruft die zugrunde liegende start()
-Methode readRepeatedly()
auf, um alle Einrichtungsoperationen auszuführen und eine Anfrage nach Daten zu stellen. Dies gibt ein Promise zurück. Wenn beim Lesen der Daten Fehler auftreten, werden diese durch die verkettete catch()
-Funktion abgefangen. In catch()
rufen wir dann error()
am Controller auf und übergeben den Grund der zugrunde liegenden Quelle.
function start(controller) {
readRepeatedly().catch((e) => controller.error(e));
}
function readRepeatedly() {
return socket.select2().then(() => {
// …
});
}
Spezifikationen
Specification |
---|
Streams Standard # ref-for-rbs-controller-error① |
Browser-Kompatibilität
BCD tables only load in the browser