O que são Buffers no Node.js?

Question

Accepted Answer

Um **Buffer** é a forma do Node lidar com **dados binários brutos** — uma sequência de bytes com comprimento fixo armazenada fora da heap V8. Como strings JavaScript são para texto (Unicode), Buffers existem para trabalhar com binários: conteúdo de arquivos, pacotes de rede, imagens, criptografia, etc.

## Por que isso importa

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

Quando você lê um arquivo ou recebe dados de rede, eles chegam como bytes — um Buffer — que você pode então decodificar para uma string se for texto, ou processar como binário se não for.

## Criando e usando 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
```

## Onde os Buffers aparecem

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

Se você ler um arquivo *sem* especificar uma codificação, você obtém um Buffer; especifique `"utf8"` e Node o decodifica para uma string para você.

## Um ponto sutil: bytes vs caracteres

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

O comprimento do Buffer está em **bytes**, que pode diferir do número de caracteres para texto multibyte (não-ASCII) — relevante ao fatiar dados binários.

## Por que isso importa

Buffers são como o Node lida com todos os **dados binários**, o que é inevitável no trabalho de servidor: ler arquivos não-texto, processar streams, protocolos de rede, criptografia, uploads de imagem/arquivo e compressão.

Entender que I/O fundamentalmente lida em bytes (Buffers) — e como converter entre Buffers e strings com a codificação correta — é essencial sempre que você vai além de texto simples, e fundamenta streams, o sistema de arquivos e criptografia.