WritableStream: abort() 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 abort()-Methode der WritableStream-Schnittstelle bricht den Stream ab, signalisiert, dass der Produzent nicht mehr erfolgreich in den Stream schreiben kann, und versetzt ihn umgehend in einen Fehlerzustand, wobei alle eingereihten Schreibvorgänge verworfen werden.
Syntax
js
abort(reason)
Parameter
reason-
Ein String, der einen menschenlesbaren Grund für den Abbruch angibt.
Rückgabewert
Ein Promise, das mit undefined erfüllt wird.
Ausnahmen
TypeError-
Der Stream, den Sie abzubrechen versuchen, ist kein
WritableStreamoder er ist gesperrt.
Beispiele
js
const writableStream = new WritableStream(
{
write(chunk) {
// …
},
close() {
// …
},
abort(err) {
// …
},
},
queuingStrategy,
);
// …
// abort the stream later on, when required
writableStream.abort();
Spezifikationen
| Spezifikation |
|---|
| Streams # ref-for-ws-abort③ |