Урок 222 минуты чтения
Как работают streams (ReadableStream, WritableStream)?
На этой странице
Кратко
Streams позволяют читать или записывать данные по частям, не загружая весь объем в память сразу.
Вопрос
Что такое ReadableStream и WritableStream и зачем они нужны?
Определение
Stream - поток данных. Вместо того чтобы ждать весь файл, ответ сервера или большой набор данных целиком, программа может получать и обрабатывать небольшие части.
ReadableStream используется для чтения данных, а WritableStream - для записи данных.
Зачем нужны streams
- обрабатывать большие файлы без лишней памяти;
- показывать данные по мере загрузки;
- строить загрузчики и прогресс-бары;
- передавать данные между API;
- работать с сетевыми ответами, файлами и трансформациями.
ReadableStream
const response = await fetch('/large-file.txt');
const reader = response.body.getReader();
while (true) {
const { value, done } = await reader.read();
if (done) break;
console.log(value); // Uint8Array с очередным куском данных
}reader.read() возвращает промис с объектом { value, done }.
WritableStream
const stream = new WritableStream({
write(chunk) {
console.log('chunk:', chunk);
},
close() {
console.log('stream closed');
},
});
const writer = stream.getWriter();
await writer.write('Hello');
await writer.write('World');
await writer.close();WritableStream принимает данные кусками и обрабатывает их в методе write.
Pipe
Потоки можно соединять:
await readableStream.pipeTo(writableStream);Так данные будут переходить из читаемого потока в записываемый.
Что важно помнить
response.bodyуfetch—ReadableStream: данные можно обрабатывать по мере поступления.- Backpressure автоматически замедляет источник, если потребитель не успевает.
TransformStreamиpipeThroughпозволяют строить конвейеры: распаковка, декодирование текста.- Стримы используют для прогресса загрузки, больших файлов и потоковых ответов LLM.
Мини-шпаргалка
response.body; // ReadableStream
stream.getReader().read(); // прочитать chunk
stream.getWriter().write(); // записать chunk
readable.pipeTo(writable); // соединить потокиДокументация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.