← Cloudflare Workers / workers / runtime-apis / streams
ReadableStream DefaultReader
Контекст
Reader используется, когда нужно читать из ReadableStream, а не перенаправляя его вывод по конвейеру в WritableStream.
A ReadableStreamDefaultReader не создается через свой конструктор. Вместо этого он получается из ReadableStream:
const { readable, writable } = new TransformStream();
const reader = readable.getReader();Свойства
-
reader.closed: Promise- Promise, который показывает, закрыт ли reader. Он выполняется (fulfilled), когда поток reader закрывается, и отклоняется (rejected), если в потоке возникает ошибка.
Методы
-
read(): Promise- Promise, который возвращает следующий доступный фрагмент данных из очереди reader.
-
cancel(reasonstringoptional): void- Отменяет поток.
reasonпредставляет собой необязательную строку в удобочитаемом формате, указывающую причину отмены.reasonбудет передан алгоритму отмены базового источника: если этот читаемый поток является одной из сторонTransformStream, тогда его алгоритм отмены переводит записываемую сторону transform в состояние ошибки сreason.
- Отменяет поток.
-
releaseLock(): void- Снимает блокировку с потока чтения (readable stream). Блокировку нельзя снять, если у читателя есть незавершённые операции чтения.
TypeErrorвыбрасывается, и читатель остаётся заблокированным.
- Снимает блокировку с потока чтения (readable stream). Блокировку нельзя снять, если у читателя есть незавершённые операции чтения.