Node'de dosya sistemiyle nasıl çalışırsınız?

Question

Accepted Answer

Yerleşik **`fs`** modülü dosyaları ve dizinleri okur ve yazar. Üç API stilini sunmuştur — **promises** (modern, tercih edilen), **callbacks** (orijinal async) ve **sync** (engelleme) — böylece duruma uygun olanı seçebilirsiniz.

## Promise API (önerilir)

```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 ile temiz bir şekilde çalışır — dosya I/O için modern standarttır.

## Callback ve sync varyantları

```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!
```

**Uyarı:** `*Sync` yöntemleri **tüm event loop'u engeller** işlem bitene kadar. Başlangıçta (yapılandırmayı bir kez yüklemek) uygunlardır ancak istek işleyicilerinde kaçınılmalıdır — engelleme okuması tüm eşzamanlı istekleri dondurur.

## Yaygın işlemler

```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
```

## Büyük dosyalar için: streams kullanın

```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"));
```

Büyük dosyalar için `readFile` her şeyi bir kez belleğe yükler; **streams** verileri sabit bellek ile öbeklerde işler.

## Neden önemli

Dosya I/O, yapılandırma yükleme, günlüğe kaydetme, dosya yükleme/indirme ve araçlandırma için Node'un temel bir yeteneğidir.

Üç API stilini bilmek — ve en önemlisi, **sync yöntemleri event loop'u engeller** (sunucularda bunlardan kaçının) ve **büyük dosyalar streams gerektirir** (değil `readFile`) — dosya işleme kodunun hem doğru hem de eşzamanlılık altında performanslı olmasını sağlamak için gereklidir.

Async/await içeren Promise API, günlük kullanım için temiz bir standarttır.