TransformStreamDefaultController: error()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juni 2022 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die error()-Methode der TransformStreamDefaultController-Schnittstelle bewirkt, dass beide Seiten des Streams auf Fehler gesetzt werden. Jegliche weitere Interaktionen damit werden mit der angegebenen Fehlermeldung fehlschlagen, und alle Chunks in der Warteschlange werden verworfen.
Syntax
error(reason)
Parameter
reason-
Ein String, der die Fehlermeldung enthält, die bei jeder weiteren Interaktion mit dem Stream zurückgegeben wird.
Rückgabewert
Keiner (undefined).
Beispiele
In diesem Beispiel wird die error()-Methode verwendet, wenn ein Chunk nicht transformiert werden konnte.
const transformContent = {
start() {
/* … */
},
async transform(chunk, controller) {
try {
chunk = await applyMyTransformation(chunk);
} catch (err) {
controller.error(`Unable to transform chunk: ${err}`);
}
// …
},
// …
};
Spezifikationen
| Spezifikation |
|---|
| Streams # ts-default-controller-error |