Jak pracujesz z systemem plików w Node?

Question

Accepted Answer

Wbudowany moduł **`fs`** odczytuje i zapisuje pliki oraz katalogi. Oferuje trzy style API — **promises** (nowoczesny, rekomendowany), **callbacks** (oryginalny async) i **sync** (blokujący) — abyś mógł wybrać właściwy dla danej sytuacji.

## Dlaczego to ważne

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

API `fs/promises` pracuje czysto z async/await — nowoczesnym standardem dla operacji na plikach.

## Warianty callback i 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!
```

**Ostrzeżenie:** Metody `*Sync` **blokują całą pętlę zdarzeń** aż do zakończenia operacji. Są w porządku przy starcie (jednorazowe ładowanie konfiguracji), ale powinno się ich unikać w handlerach żądań — blokujący odczyt zamraża wszystkie równoczesne żądania.

## Operacje typowe

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

## Dla dużych plików: użyj streamów

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

Dla dużych plików `readFile` ładuje wszystko do pamięci jednocześnie; **streamy** przetwarzają dane w partiach ze stałą pamięcią.

## Dlaczego to ważne

Operacje na plikach to podstawowa możliwość Node do ładowania konfiguracji, logowania, przesyłania/pobierania plików i narzędzi.

Znajomość trzech stylów API — i co najważniejsze, że **metody sync blokują pętlę zdarzeń** (unikaj ich w serwerach) i że **duże pliki wymagają streamów** (nie `readFile`) — jest niezbędna do pisania kodu obsługi plików, który jest zarówno poprawny, jak i wydajny w warunkach współbieżności.

API promises z async/await to czysty standard do codziennego użytku.