re:re:actable
Урок 042 минуты чтения

Чем Node streams отличаются от Web Streams?

На этой странице
Кратко

Node streams - исторический stream API Node.js, а Web Streams - стандартный API веб-платформы. Современный Node.js поддерживает оба подхода и умеет частично преобразовывать их друг в друга.

Вопрос

Чем Node streams отличаются от Web Streams и как между ними конвертировать?

Node streams

Node streams используются во многих встроенных модулях:

import { createReadStream } from 'node:fs';
 
const nodeStream = createReadStream('file.txt');

Они работают через события, методы pipe, read, write, end и совместимы с большим количеством npm-библиотек.

Web Streams

Web Streams пришли из веб-стандартов и используются в Fetch API.

const response = await fetch('https://example.com');
const webStream = response.body;

У них другой интерфейс: ReadableStream, WritableStream, TransformStream, getReader.

const reader = webStream.getReader();
const { value, done } = await reader.read();

Когда это важно?

Разница появляется, когда ты смешиваешь:

  • fetch в Node.js;
  • файловые streams;
  • web API;
  • библиотеки, которые ждут именно Node stream.

Преобразование

Многие Node streams умеют преобразовываться в Web Streams и обратно через специальные методы.

import { Readable } from 'node:stream';
import { createReadStream } from 'node:fs';
 
const nodeStream = createReadStream('file.txt');
const webStream = Readable.toWeb(nodeStream);

Что важно помнить

  • Web Streams (ReadableStream, WritableStream, TransformStream) — стандарт браузеров, доступен в Node.js глобально.
  • fetch в Node.js возвращает response.body как Web ReadableStream.
  • Конвертация: Readable.fromWeb(), Readable.toWeb(), Writable.fromWeb().
  • Web Streams удобны для кода, который работает и в браузере, и на edge-платформах.

Мини-шпаргалка

  • Node streams - классический API Node.js.
  • Web Streams - стандарт веб-платформы.
  • fetch().body возвращает Web Stream.
  • fs.createReadStream возвращает Node stream.
  • При интеграции библиотек проверяй, какой stream API ожидается.

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

Node.js: Web Streams API, MDN: Streams API.

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

Поиск

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