Conceptos Básicos de Buffers

7 ejemplos para empezar a usar Buffers: 5 básicos y 2 intermedios.

Prerrequisitos

• Node.js 24.18.0 - Buffer es global; también disponible a través de node:buffer.
• Entender cuándo usar Streams en lugar de cargar archivos completos.

Ejemplos Básicos

1. Asignar un Buffer

Crea almacenamiento binario de tamaño fijo con codificación conocida de antemano.

import { Buffer } from 'node:buffer';
 
const buf = Buffer.alloc(8); // rellenado con ceros
buf.write('hello', 0, 'utf8');
console.log(buf.toString('utf8')); // hello con relleno nulo

• Buffer.alloc(n) rellena con ceros - seguro para criptografía y secretos.
• Buffer.allocUnsafe(n) es más rápido pero puede contener memoria antigua - sobrescribe completamente antes de usar.
• Buffer.byteLength(str, 'utf8') dimensiona UTF-8 sin asignar.

Relacionado: Seguridad de Buffer - relleno con ceros y fugas

2. Crear desde String

Codifica texto en bytes con una codificación explícita.

const text = 'Node.js 24';
const buf = Buffer.from(text, 'utf8');
console.log(buf.length, Buffer.byteLength(text, 'utf8'));

• La codificación predeterminada es utf8 - especifícala explícitamente en código sensible a la seguridad.
• Las secuencias inválidas para la codificación lanzan TypeError en conversiones estrictas.
• buf.toString('hex') vuelca bytes para depurar protocolos.

Relacionado: Codificaciones de Texto - UTF-8 y entrada malformada

3. Segmentar Sin Copiar

slice devuelve una vista que comparte la misma memoria subyacente.

const original = Buffer.from('abcdef', 'utf8');
const slice = original.subarray(2, 5); // 'cde'
slice[0] = 67; // 0x43 'C'
console.log(original.toString()); // abCdef

• subarray es el alias moderno - mismo comportamiento que slice para Buffers.
• Mutar un segmento afecta al padre - copia con Buffer.from(slice) cuando necesites aislar.
• Útil para analizar marcos con prefijo de longitud sin asignaciones.

4. Comparar y Concatenar

Igualdad binaria y unión de fragmentos de lecturas de red.

const a = Buffer.from('abc');
const b = Buffer.from('abc');
console.log(a.equals(b)); // true
 
const combined = Buffer.concat([Buffer.from('hel'), Buffer.from('lo')]);

• equals es lo suficientemente seguro en cuanto a tiempo para buffers de longitud coincidente - usa crypto.timingSafeEqual para secretos.
• Buffer.concat(list, totalLength) pre-dimensiona cuando conoces la longitud final para evitar reasignaciones.
• Evita concat masivos en bucles - usa una lista y luego una concatenación o un stream.

5. Leer Archivo en Buffer (Archivos Pequeños)

Está bien para configuraciones y claves; usa streams para activos grandes.

import { readFile } from 'node:fs/promises';
 
const buf = await readFile('logo.png');
console.log(buf.length, buf[0], buf[1]); // Bytes mágicos PNG

• El archivo completo se carga en memoria - limita el tamaño del archivo para cargas no confiables.
• buf.subarray(0, 8) inspecciona números mágicos para la detección de tipos.
• Para cargas de usuarios, prefiere el streaming a un almacenamiento de objetos.

Relacionado: fs y fs/promises - E/S de archivos asíncrona

Ejemplos Intermedios

6. Interoperabilidad con Uint8Array

Las APIs web y los cuerpos de fetch usan Uint8Array - los Buffers son subclases de Uint8Array.

const buf = Buffer.from([1, 2, 3]);
const view: Uint8Array = buf;
console.log(view instanceof Uint8Array); // true
 
const copy = Buffer.from(view); // copia cuando se necesita aislamiento

• Las vistas de ArrayBuffer de WASM o Web Crypto interoperan a través de .buffer, .byteOffset, .byteLength.
• Ten cuidado con las vistas de memoria compartida - copia antes de la entrega asíncrona si vas a mutar.
• Buffer.from(arrayBuffer, byteOffset, length) crea un Buffer respaldado por una vista.

7. Mensaje con Prefijo de Longitud

Patrón común de enmarcado binario para protocolos TCP.

function encodeFrame(payload: Buffer): Buffer {
  const header = Buffer.alloc(4);
  header.writeUInt32BE(payload.length);
  return Buffer.concat([header, payload]);
}
 
function decodeFrame(data: Buffer): { frame: Buffer; rest: Buffer } {
  const len = data.readUInt32BE(0);
  return { frame: data.subarray(4, 4 + len), rest: data.subarray(4 + len) };
}

• Usa el orden de bytes de red big-endian (BE) por convención.
• TCP puede entregar tramas parciales - acumula en una lista de Buffer hasta que esté completa.
• Consulta Protocolos Binarios para analizadores de producción.

Relacionado: Conceptos Básicos de Streams - manejo de cargas grandes

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.