Melhores Práticas de Buffers

Buffers são a ferramenta certa para trabalhos binários pequenos e de tamanho conhecido - para todo o resto, limite os tamanhos, prefira streams e trate codificação e segredos explicitamente.

Como Usar Esta Lista

• Aplique a manipuladores de upload, webhooks, parsers TCP e utilitários de criptografia.
• Qualquer item não verificado é um bloqueador para caminhos que aceitam bytes não confiáveis.
• Combine com Melhores Práticas de Streams para I/O grande.
• Itens de segurança são obrigatórios para fluxos de autenticação e pagamento.

A - Tamanho e Memória

• Transmita arquivos maiores que alguns MB em vez de readFile para um único Buffer. Memória constante sob carga.
• Aplique limites MAX_FRAME ou de tamanho de corpo em parsers binários. Rejeite prefixos de comprimento excessivos antes da alocação.
• Pré-dimensionar Buffer.concat quando o comprimento total for conhecido. Evite realocação O(n²) em muitos pedaços.
• Evite acumular arrays de chunks ilimitados de sockets. Analise incrementalmente ou use streams Transform.
• Monitore o heap ao lidar com uploads. Alerte sobre crescimento correlacionado com o tráfego.

B - Alocação e Codificação

• Use Buffer.alloc para segredos e material criptográfico. Não allocUnsafe a menos que seja imediatamente sobrescrito completamente.
• Especifique utf8 explicitamente em toString/from para texto. Documente codificações legadas em ADR se for inevitável.
• Use TextDecoder com fatal: true para protocolos de texto de entrada. Rejeite sequências malformadas na fronteira.
• Normalize Unicode (NFC) antes de comparar identificadores de usuário. Previne bypass de homógrafos.
• Use Buffer.byteLength para limites de tamanho UTF-8. Não .length da string.

C - Segurança

• Compare segredos com crypto.timingSafeEqual em digests de comprimento igual. Não use === bruto em chaves de API.
• Nunca ecoe o conteúdo do buffer em erros ou logs. Mensagens genéricas para o cliente; IDs de correlação no lado do servidor.
• Limpe buffers de chave de curta duração em finally quando viável. buffer.fill(0) higiene de melhor esforço.
• Analise HMAC/assinaturas no Buffer do corpo bruto antes da análise JSON. Preserve o payload exato em bytes para verificação.
• Limite o tamanho de decodificação hex/base64. Previne bombas de descompressão.

D - Protocolos e Interoperabilidade

• Documente a endianidade e o layout do frame na especificação do protocolo. Big-endian, a menos que seja declarado o contrário.
• Manipule leituras TCP parciais com um acumulador. Nunca assuma que o evento data corresponde a uma mensagem.
• Versionar tipos de mensagens binárias ou usar esquemas protobuf/msgpack. Contratos evolutivos.
• Prefira subarray em vez de slice para visualizações de zero-copiagem. Copie ao reter além da próxima leitura.
• Use APIs Web padrão TextEncoder/Uint8Array nas fronteiras de fetch. Interoperabilidade com clientes do navegador.

E - Quando Não Usar Buffers

• Não represente objetos de domínio como Buffers brutos na lógica de negócios. Analise para estruturas tipadas na fronteira.
• Não use Buffers para números - use arrays tipados ou protobuf. Esquema claro supera bytes ad-hoc.
• Não stringifique binários como latin1 para "preservação". Use hex/base64 explícito com limites de tamanho em vez disso.
• Use streams ao transformar payloads grandes. gzip, parser CSV, pipelines de upload S3.
• Use JSON quando a depurabilidade superar a eficiência de bytes. Binário apenas com necessidade medida.

FAQs

Relacionados

• Noções Básicas de Buffers - APIs principais
• Segurança de Buffer - comparação segura em tempo
• Melhores Práticas de Streams - caminhos de dados grandes
• Protocolos Binários - padrões de framing

Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 e NestJS 11.