ReadableStreamBYOBReader: метод cancel()

Метод cancel() интерфейса ReadableStreamBYOBReader возвращает Promise, который выполняется, когда поток отменён. Вызов этого метода сигнализирует о потере интереса к потоку потребителем.

reason Необязательно

Описание причины отмены, понятное человеку. Источник может или не может его использовать.

A Promise, который выполняется со значением, заданным в параметре reason.

TypeError

Объект источника не является ReadableStreamBYOBReader, или у потока нет владельца.

В этом примере кода метод cancel() вызывается при нажатии кнопки, передавая строку "user choice" в качестве причины. Обещание выполняется при завершении отмены.

button.addEventListener("click", () => {
  reader.cancel("user choice").then(() => console.log(`cancel complete`));
});

Обратите внимание, что этот код можно увидеть, работающий в примере кода Использование читаемых байтовых потоков (нажмите кнопку Отменить поток).

• ReadableStreamBYOBReader() конструктор
• Использование читаемого байтового потока