Miten työskentelet tiedostojärjestelmän kanssa Node:ssa?

Question

Accepted Answer

Sisäänrakennettu **`fs`** -moduuli lukee ja kirjoittaa tiedostoja ja hakemistoja. Se tarjoaa kolme API-tyyliä — **promises** (moderni, suositeltu), **callbacks** (alkuperäinen asynkroninen) ja **sync** (estävä) — joten voit valita oikean tilanteeseen.

## Promise API (suositeltu)

```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 toimii puhtaasti async/await:in kanssa — moderni oletus tiedosto-I/O:lle.

## Callback- ja sync-variantit

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

**Varoitus:** `*Sync` -menetelmät **estävät koko tapahtumalooppia**, kunnes operaatio valmistuu. Ne ovat kunnossa käynnistyksen yhteydessä (lataa asetukset kerran), mutta niitä tulee välttää pyyntöenkäsittelijöissä — estävä luku jäädyttää kaikki samanaikaiset pyynnöt.

## Yleiset operaatiot

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

## Suurille tiedostoille: käytä virtoja

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

Suurille tiedostoille `readFile` lataa kaiken muistiin kerralla; **virrat** käsittelevät tietoja paloissa vakiomuistilla.

## Miksi se on tärkeää

Tiedosto-I/O on Node:n ydinkyky konfiguraation lataamiseen, lokitukseen, tiedostojen lataaukseen/lataukseen ja työkaluihin.

Kolmen API-tyylin tunteminen — ja kriittisesti, että **sync-menetelmät estävät tapahtumalooppia** (välttä niitä palvelimissa) ja että **suuret tiedostot tarvitsevat virtoja** (ei `readFile`) — on olennaista kirjoitettaessa tiedoston käsittelykoodia, joka on sekä oikea että tehokas samanaikaisuuden alla.

Promise API async/await:in kanssa on puhdas oletus päivittäiseen käyttöön.