Armazenamento temporário durante uma transferência
Um buffer é uma região de memória usada para guardar conteúdo temporariamente durante sua leitura, processamento ou transferência. Ao receber um arquivo pela rede, por exemplo, a aplicação pode manter uma parte dos bytes em memória até conseguir processá-los ou gravá-los no destino.
Esse armazenamento permite separar o recebimento do consumo do conteúdo. A aplicação precisa acompanhar a quantidade de bytes disponíveis, porque uma parte recebida pode conter apenas um trecho do arquivo. A presença do buffer não indica que a transferência inteira terminou.
Bytes e texto no Node.js
A classe Buffer do Node.js armazena uma sequência de bytes de tamanho fixo. Neste exemplo, o programa transforma um texto em bytes usando UTF-8 e depois faz a conversão de volta para texto:
const buffer = Buffer.from('ação', 'utf8')console.log(buffer.length)console.log(buffer.toString('utf8'))A saída é 6 na primeira linha e ação na segunda. O texto possui quatro caracteres, mas ç e ã ocupam dois bytes cada em UTF-8. Portanto, o tamanho do buffer mede bytes, não a quantidade de caracteres exibidos.
Capacidade e limites de leitura
A codificação só deve ser aplicada quando o conteúdo representa texto. Converter bytes de uma imagem com toString('utf8') não decodifica o formato da imagem.
Os métodos de leitura também precisam respeitar a capacidade disponível. No Node.js, readUInt32BE lê quatro bytes a partir de uma posição, por isso essa posição deve deixar espaço para os quatro dentro do buffer. A documentação do Buffer detalha os limites e os erros desses métodos.
Dúvidas frequentes
Perguntas frequentes sobre buffer
- Um buffer guarda apenas texto?
- Ele pode armazenar bytes de um arquivo, uma imagem ou uma mensagem de rede. Para interpretar o conteúdo como texto, o programa precisa utilizar a codificação correspondente.
- O Buffer do Node.js aumenta ao receber mais conteúdo?
- Cada objeto Buffer tem tamanho fixo. Para reunir conteúdo maior, o programa precisa usar outro buffer com capacidade suficiente ou processar o conteúdo em partes.
- O que acontece ao ler além do tamanho do Buffer?
- O comportamento depende do acesso utilizado. Os métodos de leitura numérica, como readUInt32BE, exigem espaço para todos os bytes da leitura e lançam erro quando a posição excede os limites.
Para continuar
Recursos relacionados
Documentação
MDN: armazenamento temporário em buffer
Define o buffer como armazenamento temporário em memória durante a transferência de conteúdo.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Na sessão de Desenvolvimento Colaborativo, você revisa o código no editor com orientação técnica para investigar erros de processamento.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar código produzido por agentes, você precisa conferir como a aplicação recebe bytes e os converte em texto.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.