Урок 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 ожидается.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.