რა არის stream-ი Node.js-ში და როდის უნდა გამოიყენოთ ის?

Question

Accepted Answer

**Stream-ები** ამუშავებენ მონაცემებს **ქვემეასრულად, ნაწილებში**, ვიდრე ყველაფერი ერთდროულად მეხსიერებაში ჩაბარდეს. ეს აუცილებელია დიდი მონაცემებისთვის (დიდი ფაილები, ქსელის გადაცემა), სადაც ყველაფრის buffer-ირება მეხსიერება ამოწურავდა.

## პრობლემა, რომელიც stream-ები ხსნიან

```js
// ❌ loads the ENTIRE file into memory — crashes on a 10GB file
const data = await fs.promises.readFile("huge.csv");
process(data);

// ✅ stream it — constant memory, processes chunk by chunk
fs.createReadStream("huge.csv")
  .pipe(transform)
  .pipe(fs.createWriteStream("out.csv"));
```

stream-ებით, მეხსიერების გამოყენება დარჩება ბრტყელი ფაილის ზომის მიუხედავად — თქვენ ამუშავებთ ერთი ნაწილი ერთბაშად.

## stream-ის ოთხი ტიპი

```text
Readable  → source you read FROM (fs.createReadStream, http request)
Writable  → destination you write TO (fs.createWriteStream, http response)
Duplex    → both readable & writable (TCP socket)
Transform → modify data as it passes through (zlib gzip, encryption)
```

## pipe — დააკავშირე stream-ები

```js
import { createReadStream, createWriteStream } from "fs";
import { createGzip } from "zlib";

// read → compress → write, all streaming, low memory
createReadStream("file.txt")
  .pipe(createGzip())            // Transform: compress on the fly
  .pipe(createWriteStream("file.txt.gz"));
```

`pipe` აკავშირებს კითხვადს ჩაწერადთან (გარდაქმნებით შორის), ავტომატურად აკონტროლებს ნაკადს — stream-ების დაკომპოზიციის იდიომატური გზა.

## pipeline — pipe სათანადო ხარვეზების დამუშავებით

```js
import { pipeline } from "stream/promises";

await pipeline(
  createReadStream("in.txt"),
  createGzip(),
  createWriteStream("out.gz")
); // ✅ cleans up all streams on error/completion (pipe alone leaks on errors)
```

`pipeline` არის უპირატესი ჯაჭვური `.pipe()` ზე, რადგან იგი ვრცელდება ხარვეზებზე და სწორად ასუფთავებს თითოეულ stream-ს.

## სად ჩნდება stream-ები

```text
✓ HTTP request/response bodies (req and res ARE streams)
✓ File reading/writing, file uploads/downloads
✓ Compression (zlib), encryption (crypto)
✓ Database cursors, large query results
✓ Real-time data processing, video streaming
```

## როდის არ უნდა წუხილი

```text
Small data that fits comfortably in memory → readFile/simple buffering is simpler.
Streams add complexity; use them for LARGE or continuous data.
```

## რატომ აქვს ეს მნიშვნელობა

Stream-ები არის Node-ის განმსაზღვრელი მახასიათებელი დიდი ან უწყვეტი მონაცემების **მეხსიერების ეფექტური** დამუშავებისთვის — განსხვავება აპლიკაციას შორის, რომელიც დიდ ატვირთვაზე ვარდება და ის, რომელიც ნებისმიერი ზომის მოპყრობა ხდება ბრტყელი მეხსიერებით.

ოთხი ტიპის, `pipe`/`pipeline` კომპოზიციის გაგება (და რატომ `pipeline` უფრო უსაფრთხო), და რომ HTTP მოთხოვნები/პასუხები თავად stream-ები არიან, აუცილებელია Node-ში სკალირებადი ფაილის დამუშავების, მონაცემების დამუშავებისა და proxy სერვისების ასაგებად.