ReadableStreamBYOBReader.cancel()
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The cancel() method of the
ReadableStreamBYOBReader interface returns a Promise that resolves when the stream is canceled. Calling this method signals a loss of interest in the stream by a consumer.
Note: If the reader is active, the cancel() method
behaves the same as that for the associated stream
(ReadableStream.cancel()).
Syntax
var promise = readableStreamBYOBReader.cancel(reason);
Parameters
- reason Optional
-
A human-readable reason for the cancellation. The underlying source may or may not use it.
Return value
A Promise, which fulfills with the value given in the reason
parameter.
Exceptions
- TypeError
-
The source object is not a
ReadableStreamBYOBReader, or the stream has no owner.
Examples
TBD.
Specifications
| Specification |
|---|
| Streams Standard # ref-for-generic-reader-cancel② |
Browser compatibility
BCD tables only load in the browser