WritableStreamDefaultController: error() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Mai 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die error() Methode der WritableStreamDefaultController Schnittstelle verursacht, dass alle zukünftigen Interaktionen mit dem zugehörigen Stream fehlerhaft werden.
Diese Methode wird selten verwendet, da es normalerweise ausreicht, ein abgelehntes Promise von einer der Methoden des zugrunde liegenden Sinks zurückzugeben. Sie kann jedoch nützlich sein, um einen Stream plötzlich in Reaktion auf ein Ereignis außerhalb des normalen Lebenszyklus von Interaktionen mit dem zugrunde liegenden Sink zu beenden.
Syntax
error(message)
Parameter
message-
Ein String, der den Fehler repräsentiert, mit dem zukünftige Interaktionen fehlschlagen sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Der Stream, den Sie fehlerhaft machen möchten, ist kein
WritableStream.
Beispiele
const writableStream = new WritableStream({
start(controller) {
// do stuff with controller
// error stream if necessary
controller.error("My error is broken");
},
write(chunk, controller) {
// …
},
close(controller) {
// …
},
abort(err) {
// …
},
});
Spezifikationen
| Spezifikation |
|---|
| Streams # ref-for-ws-default-controller-error① |