re:re:actable
Урок 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);  // соединить потоки

Документация

MDN: Streams API, web.dev: Streams.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам