Como resolver APIs do Node.js por meio de polyfills

Aprenda a configurar e usar APIs do Node.js através de polyfills.

Ver como Markdown

Através da Azion CLI, você pode inicializar uma aplicação baseada em templates ou vincular um projeto existente. A lista de web frameworks inclui Next.js, React, Vue, Angular, Astro, JavaScript e outros. Esses frameworks JavaScript são executados no edge da Azion, em cima do Azion Runtime.

Os projetos com esses frameworks geralmente fazem uso de APIs de Node.js. Através do processo de build da Azion, realizado pelo Azion Bundler, essas APIs são resolvidas através do uso de polyfills.

Este guia mostrará como usar a API Buffer do Node.js através de polyfills em um projeto JavaScript na Azion usando a Azion CLI e o Azion Bundler.

Pré-requisitos

Antes de começar, você deve ter:

Inicialize um projeto JavaScript

  1. No terminal, inicialize o projeto:
azion init
  1. Digite o nome polyfills-guide:
Your applications name: (glorious-curiosity) polyfills-guide
  1. Escolha o template de JavaScript:

Você pode começar a digitar o nome do preset para filtrar os resultados.

? Choose a preset: [Use arrows to move, type to filter]
Angular
Astro
Docusaurus
Eleventy
Emscripten
Gatsby
Hexo
Hono
Hugo
> Javascript
Jekyll
...
  1. Escolha o template Hello World:

Você pode começar a digitar o nome do template para filtrar os resultados.

? Choose a template: [Use arrows to move, type to filter]
Azion SQL Database
Drizzle + Neon Sample
Drizzle + TiDB Sample
Drizzle + Turso Sample
Functions GitHub AutoDeploy
Fauna DB Boilerplate
> Hello World
HTMX Boilerplate
Simple Javascript Router Node
...

  1. Digite y para iniciar um servidor de desenvolvimento local.

  2. Digite y para instalar as dependências do projeto.

  3. Acesse a porta que foi retornada no terminal. Exemplo:

[Azion Bundler] [Server] › ✔ success Function running on port 0.0.0.0:3333, url: http://localhost:3333

  1. Retorne ao terminal e encerre o processo.

  2. Acesse seu projeto:

cd polyfills-guide
  1. Abra o arquivo azion.config.js. Você verá algo semelhante a isto:
polyfills-guide/azion.config.js
import { defineConfig } from 'azion';
export default defineConfig({
build: {
entry: 'main.js',
preset: {
name: 'javascript',
},
},
});

Este é o arquivo onde você pode adicionar configurações específicas para o seu projeto. Por exemplo, a propriedade polyfills pode ser definida como true ou false para controlar se os polyfills devem ou não ser permitidos:

polyfills-guide/azion.config.js
import { defineConfig } from 'azion';
export default defineConfig({
build: {
entry: 'main.js',
preset: {
name: 'javascript',
},
polyfills: true, // permite usar polyfills
},
});

Em nosso exemplo, você pode deixar o arquivo como está. Os polyfills são permitidos por padrão.

Para mais informações sobre como configurar o seu projeto, verifique a referência do arquivo azion.config.js.

  1. Após aplicar estas configurações, você pode importar as APIs necessárias para o seu projeto. Neste exemplo, estamos usando a API Buffer do Node.js:

Dentro do arquivo main.js:

polyfills-guide/main.js
// Importa a classe Buffer do módulo 'buffer' no Node.js
import { Buffer } from "node:buffer";
const main = async (event) => {
// Cria um buffer a partir da string "Hello Edge!" com codificação UTF-8
const helloBuffer = Buffer.from("Hello Edge!", "utf8");
// Registra o conteúdo do buffer como uma string hexadecimal
console.log(helloBuffer.toString("hex"));
// Saída esperada: 48656c6c6f204564676521
// Registra o conteúdo do buffer como uma string base64
console.log(helloBuffer.toString("base64"));
// Saída esperada: SGVsbG8gRWRnZSE=
// Sobrescreve parte do buffer com a string "World" no deslocamento e comprimento especificados
helloBuffer.write("World", 6, 5, "utf8");
// Registra o conteúdo atualizado do buffer como uma string
console.log(helloBuffer.toString());
// Saída esperada: Hello World!
// Retorna o conteúdo do buffer como uma resposta com um status 200
return new Response(helloBuffer.toString(), { status: 200 });
};
export default main;
  1. Execute o projeto localmente rodando:
azion dev

Agora você pode verificar os logs no terminal e ver a API Buffer funcionando através de polyfills.

Você pode acessar uma lista de APIs que são resolvidas através de polyfills no repósitório do Azion Bundler e na documentacão de compatibilidade da Azion. Azion Bundler é um projeto open-source e você pode propor novos presets e implementações.

Fazer o deploy da function na Azion

Após testar localmente com azion dev, faça o deploy da sua function para a Azion Platform:

  1. Execute o comando de deploy:
azion deploy

O CLI realiza o build do projeto, aplica os polyfills configurados e publica a function na plataforma. Ao final do processo, você receberá a URL de acesso à sua aplicação.

Opções úteis do comando deploy

FlagDescrição
--autoExecuta o fluxo completo de build, provisionamento e distribuição sem interrupções ou prompts interativos.
--workers <número>Define o número de workers paralelos para upload de arquivos estáticos para o Object Storage. Por padrão, é calculado automaticamente com base nos núcleos de CPU disponíveis (máximo: 20).
--dry-runSimula o processo de deploy localmente, validando as regras de roteamento geradas sem afetar recursos em produção.

Exemplo com flags:

azion deploy --auto --workers 10

O processo de build aplica os polyfills automaticamente com base na configuração do arquivo azion.config.js. Certifique-se de que os módulos necessários estão listados na propriedade polyfills antes de fazer o deploy.