Draft
This page is not complete.
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The error()
method of the WritableStreamDefaultController
interface causes any future interactions with the associated stream to error.
This method is rarely used, since usually it suffices to return a rejected promise from one of the underlying sinkβs methods. However, it can be useful for suddenly shutting down a stream in response to an event outside the normal lifecycle of interactions with the underlying sink.
Syntax
writableStreamDefaultController.error(e);
Parameters
- e
- A
DOMString
representing the error you want future interactions to fail with.
Return value
undefined
.
Exceptions
- TypeError
- The stream you are trying to error is not a
WritableStream
.
Examples
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) {
...
}
});
Specifications
Specification | Status | Comment |
---|---|---|
Streams The definition of 'error()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
error | Chrome ? | Edge Full support 16 | Firefox No support No | IE ? | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android No support No | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.