როგორ იმუშავებ ფайლის სისტემაზე Node-ში?

Question

Accepted Answer

ჩაშენებული **`fs`** მოდული წაკითხულებს და წერს ფайლებს და დიректორიებს. ის სთავაზობს სამ API სტილს — **promises** (მოდერნი, რეკომენდირებული), **callbacks** (ორიგინალური async) და **sync** (blocking) — ისე რომ აირჩიოთ სიტუაციისთვის სწორი.

## The promise API (recommended)

```js
import { readFile, writeFile, mkdir, readdir } from "fs/promises";

async function work() {
  const data = await readFile("input.txt", "utf8");     // read (utf8 → string)
  await writeFile("output.txt", "Hello");                // write (overwrites)
  await mkdir("new-dir", { recursive: true });           // create dirs (recursive = mkdir -p)
  const files = await readdir("./");                      // list directory contents
}
```

`fs/promises` API 깨끗ად მუშაობს async/await-თან — მოდერნი სტანდარტი ფაილის I/O-სთვის.

## Callback და sync ვარიანტები

```js
import fs from "fs";

fs.readFile("file.txt", "utf8", (err, data) => { ... }); // async callback
const data = fs.readFileSync("file.txt", "utf8");         // SYNC — blocks the event loop!
```

**გაფრთხოვება:** `*Sync` მეთოდები **ზღუდავენ მთელ event loop-ს** სანამ ოპერაცია დასრულდება. ისინი კარგია სტარტআპზე (კონფიგის ერთჯერ ჩატვირთვა) მაგრამ უნდა თავიდან ავიცილოთ request handlers-ში — blocking read ყინავს ყველა concurrent request-ს.

## ჩვეულებრივი ოპერაციები

```js
await fs.promises.appendFile("log.txt", "new line
"); // append
await fs.promises.unlink("old.txt");                    // delete a file
await fs.promises.rename("a.txt", "b.txt");             // rename/move
const stats = await fs.promises.stat("file.txt");       // metadata (size, mtime)
const exists = fs.existsSync("file.txt");               // check existence
```

## დიდი ფაილების შემთხვევაში: გამოიყენეთ streams

```js
// ❌ readFile loads the WHOLE file into memory — bad for huge files
const huge = await readFile("10gb.txt"); // could exhaust memory

// ✅ stream it in chunks (constant memory)
fs.createReadStream("10gb.txt").pipe(fs.createWriteStream("copy.txt"));
```

დიდი ფაილების სმთხვევაში, `readFile` ჩატვირთავს ყველაფერს მეხსიერებაში ერთდროულად; **streams** დამუშავებს მონაცემებს ნაწილებში მუდმივი მეხსიერებით.

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

ფაილის I/O არის Node-ის ძირითადი შესაძლებლობა კონფიგის ჩატვირთვისთვის, ლოგირებისთვის, ფაილების ატვირთვა/ჩამოტვირთვისთვის და tooling-ისთვის.

სამი API სტილის ცოდნა — და კრიტიკულად, რომ **sync მეთოდები ზღუდავენ event loop-ს** (თავიდან აიცილეთ servers-ში) და რომ **დიდი ფაილები საჭიროებენ streams** (არა `readFile`) — აუცილებელია ფაილების დამუშავების კოდის დასაწერად, რომელიც სწორი და გამოსადეგი საკონკურენციო საფუძველზე.

Promise API async/await-თან ერთად არის სუფთა სტანდარტი ყოველდღიური გამოყენებისთვის.