node:string_decoder

O módulo node:string_decoder no Azion Runtime: como StringDecoder converte dados de Buffer em strings e um exemplo que decodifica um caractere multibyte.

Última atualização

Ver como Markdown Configurar agente

O módulo node:string_decoder decodifica objetos Buffer em strings, como descreve a documentação do string_decoder do Node.js. Use-o quando dados binários chegam em partes, como o corpo de uma requisição ou de uma resposta enviado em chunks, e um caractere multibyte pode ficar dividido entre duas partes. No Azion Runtime, o build aceita import string_decoder from "node:string_decoder", e StringDecoder retorna os mesmos valores em uma function com deploy feito e com azion dev.

Um StringDecoder criado com utf8 guarda um caractere incompleto entre as chamadas de write(). Ao receber os bytes 0xe2 0x82, ele retorna uma string vazia; ao receber o byte seguinte, 0xac, ele retorna €; e end() retorna então uma string vazia. Em um decoder criado com base64, write() de ab seguido de end() de c retorna YWJj no conjunto das duas chamadas. Buffer é um global, por isso uma function pode chamar Buffer.from() sem importar node:buffer.

Exemplo

A function abaixo decodifica os dois bytes do caractere ¢, registra o resultado em log e o retorna no corpo da resposta:

JavaScript
01/**
02 * An example of using the Node.js StringDecoder API in an Azion Function.
03 * @example
04 * // Build and run locally with the Azion CLI:
05 * azion build
06 * azion dev
07 */
08import string_decoder from "node:string_decoder";
09
10/**
11 * An example of using the Node.js StringDecoder API in an Azion Function.
12 * @param {*} event
13 * @returns {Promise<Response>}
14 */
15const main = async (event) => {
16 const decoder = new string_decoder.StringDecoder("utf8");
17 const buffer = Buffer.from([0xc2, 0xa2]);
18 const decoded = decoder.write(buffer);
19 console.log(decoded);
20 // ¢
21
22 return new Response(decoded, { status: 200 });
23};
24
25export default main;

A function registra ¢ em log e responde com o status 200 e este corpo:

¢

Recursos relacionados

APIs do Node.js

Todos os módulos do Node.js que o Azion Runtime resolve e como cada um se comporta.

node:buffer

A classe Buffer, cujos objetos um StringDecoder lê.

Use APIs do Node.js com polyfills

Como o build resolve APIs do Node.js por meio de polyfills, mostrado em um projeto JavaScript.

Handlers

O formato de handler recomendado e o aviso que azion build imprime para o formato export default main que este exemplo usa.