Buenas Prácticas para Buffers

Los Buffers son la herramienta adecuada para trabajos binarios pequeños y de tamaño conocido; para todo lo demás, limita los tamaños, prefiere los streams y trata la codificación y los secretos de forma explícita.

Cómo Usar Esta Lista

• Aplícala a manejadores de carga, webhooks, parsers TCP y utilidades criptográficas.
• Cualquier elemento sin marcar es un bloqueador para rutas que aceptan bytes no confiables.
• Combínala con Buenas Prácticas para Streams para E/S grandes.
• Los elementos de seguridad son obligatorios para flujos de autenticación y pago.

A - Tamaño y Memoria

• Transmite archivos de más de unos pocos MB en lugar de readFile en un solo Buffer. Memoria constante bajo carga.
• Aplica límites de MAX_FRAME o tamaño de cuerpo en parsers binarios. Rechaza prefijos de longitud de tamaño excesivo antes de la asignación.
• Pre-dimensiona Buffer.concat cuando se conoce la longitud total. Evita la reasignación O(n²) en muchos fragmentos.
• Evita acumular arrays de fragmentos ilimitados de sockets. Parsear incrementalmente o usar streams Transform.
• Monitorea el heap al manejar cargas. Alerta sobre el crecimiento correlacionado con el tráfico.

B - Asignación y Codificación

• Usa Buffer.alloc para secretos y material criptográfico. No allocUnsafe a menos que se sobrescriba completamente de inmediato.
• Especifica utf8 explícitamente en toString/from para texto. Documenta las codificaciones heredadas en ADR si es inevitable.
• Usa TextDecoder con fatal: true para protocolos de texto entrantes. Rechaza secuencias mal formadas en el límite.
• Normaliza Unicode (NFC) antes de comparar identificadores de usuario. Previene el bypass de homógrafos.
• Usa Buffer.byteLength para límites de tamaño UTF-8. No .length de cadena.

C - Seguridad

• Compara secretos con crypto.timingSafeEqual en resúmenes de igual longitud. No === directo en claves API.
• Nunca hagas eco del contenido del buffer en errores o registros. Mensajes genéricos para el cliente; IDs de correlación del lado del servidor.
• Limpia los buffers de claves de corta duración en finally cuando sea factible. buffer.fill(0) higiene de mejor esfuerzo.
• Parsear HMAC/firmas en el Buffer del cuerpo crudo antes de parsear JSON. Preserva la carga útil exacta en bytes para la verificación.
• Limita el tamaño de salida de la decodificación hex/base64. Previene bombas de descompresión.

D - Protocolos e Interoperabilidad

• Documenta la endianness y el diseño del frame en la especificación del protocolo. Big-endian a menos que se indique lo contrario.
• Maneja lecturas TCP parciales con un acumulador. Nunca asumas que un evento data equivale a un mensaje.
• Versiona los tipos de mensajes binarios o usa esquemas protobuf/msgpack. Contratos evolucionables.
• Prefiere subarray sobre slice para vistas de copia cero. Copia cuando se retiene más allá de la siguiente lectura.
• Usa TextEncoder/Uint8Array estándar web en los límites de fetch. Interoperabilidad con clientes de navegador.

E - Cuándo No Usar Buffers

• No representes objetos de dominio como Buffers crudos en la lógica de negocio. Parsear a estructuras tipadas en el límite.
• No uses Buffers para números; usa arrays tipados o protobuf. Un esquema claro supera a los bytes ad-hoc.
• No conviertas binario a cadena como latin1 para "preservación". Hex/base64 explícito con límites de tamaño en su lugar.
• Recurre a streams al transformar cargas grandes. gzip, parseo de CSV, pipelines de carga a S3.
• Recurre a JSON cuando la depuración supera la eficiencia de bytes. Binario solo con necesidad medida.

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de Buffers - APIs principales
• Seguridad de Buffers - comparación segura en tiempo
• Buenas Prácticas para Streams - rutas de datos grandes
• Protocolos Binarios - patrones de enmarcado

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.