Ce sunt Buffers în Node.js?

Question

Accepted Answer

Un **Buffer** este modul Node de a gestiona **date binare brute** — o secvență de octeți cu lungime fixă stocată în afara heap-ului V8. Deoarece șirurile JavaScript sunt pentru text (Unicode), Buffers-urile există pentru a lucra cu binari: conținut de fișiere, pachete de rețea, imagini, criptare, etc.

## De ce contează

```text
JavaScript strings → text (UTF-16). Can't cleanly represent arbitrary bytes.
Buffers → raw bytes (0–255 each). For binary data that isn't text.
```

Când citești un fișier sau primești date din rețea, ele sosesc ca octeți — un Buffer — pe care-l poți apoi decodifica într-un șir dacă este text, sau procesa ca binar dacă nu este.

## Crearea și utilizarea Buffers

```js
const buf = Buffer.from("Hello");          // from a string → bytes
const buf2 = Buffer.from([72, 105]);       // from byte values → "Hi"
const buf3 = Buffer.alloc(10);             // 10 zero-filled bytes

buf.length;          // 5 (bytes, not characters)
buf.toString("utf8"); // "Hello" — decode back to text
buf.toString("hex");  // "48656c6c6f"
buf.toString("base64"); // "SGVsbG8="
buf[0];              // 72 — access individual bytes
```

## Unde apar Buffers

```js
// file reads without an encoding return a Buffer
const data = await fs.promises.readFile("image.png"); // Buffer (binary)
const text = await fs.promises.readFile("file.txt", "utf8"); // string (decoded)

// streams emit Buffer chunks
req.on("data", (chunk) => { /* chunk is a Buffer */ });

// crypto, compression, network protocols all work with Buffers
crypto.randomBytes(16); // a Buffer of 16 random bytes
```

Dacă citești un fișier *fără* a specifica o codificare, obții un Buffer; specifică `"utf8"` și Node-ul îl decodifică în șir pentru tine.

## Un punct delicat: octeți vs caractere

```js
Buffer.from("café").length; // 5 (é is 2 bytes in UTF-8) — NOT 4 characters
```

Lungimea Buffer-ului este în **octeți**, care poate diferi de numărul de caractere pentru text multibyte (non-ASCII) — relevant atunci când tai date binare.

## De ce contează

Buffers-urile sunt modul în care Node gestionează toate **datele binare**, care este inevitabil în munca de server: citire de fișiere non-text, procesare de fluxuri, protocoale de rețea, criptare, încărcări de imagini/fișiere și compresie.

Înțelegerea că I/O funcționează fundamental cu octeți (Buffers) — și cum se convertește între Buffers și șiruri cu codificarea corectă — este esențial ori de câte ori mergi dincolo de text simplu, și fundamentează fluxurile, sistemul de fișiere și cripto.