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