Hono no Node vs Edge

Implante a mesma API Hono no Node 24 ou em runtimes de edge (Cloudflare Workers, Deno, Bun) com trade-offs de portabilidade.

Receita

Padrão de portabilidade de referência rápida.

// app compartilhada (agnóstica ao runtime)
import { Hono } from "hono";
 
export const app = new Hono();
 
app.get("/health", (c) => c.json({ ok: true }));
app.get("/users/:id", (c) => c.json({ id: c.req.param("id") }));
 
// Entrada Node: src/node.ts
import { serve } from "@hono/node-server";
import { app } from "./app.js";
serve({ fetch: app.fetch, port: 3000 });
 
// Entrada Cloudflare Worker: src/worker.ts
import { app } from "./app.js";
export default app;

Quando usar isso: APIs que devem rodar tanto em servidores tradicionais quanto em edge/CDN para latência ou estratégia de múltiplos runtimes.

Exemplo de Trabalho

App portátil com adaptadores específicos do runtime:

// app.ts - rotas compartilhadas
import { Hono } from "hono";
import { cors } from "hono/cors";
 
export function createApp() {
  const app = new Hono();
  app.use("*", cors());
  app.get("/api/status", (c) => c.json({ runtime: "hono" }));
  return app;
}
 
// node.ts
import { serve } from "@hono/node-server";
import { createApp } from "./app.js";
 
const app = createApp();
serve({ fetch: app.fetch, port: Number(process.env.PORT ?? 3000) });
 
// worker.ts (Cloudflare)
import { createApp } from "./app.js";
export default createApp();
 
// wrangler.toml
// name = "my-api"
// main = "src/worker.ts"
// compatibility_date = "2024-01-01"

O que isso demonstra:

• Fábrica createApp() compartilhada para todos os runtimes
• Node usa @hono/node-server; Workers exportam o app diretamente
• CORS e rotas são agnósticos ao runtime
• Configuração de ambiente difere por alvo de implantação

Análise Profunda

Comparação de Runtimes

O que Porta Limpamente

• Definições de rota e middleware
• Manipulação de requisição/resposta JSON
• Validação Zod via @hono/zod-validator
• Autenticação JWT via hono/jwt
• Cabeçalhos CORS e de segurança

O que Não Porta

• Uso direto de node:fs, node:net
• Drivers de banco de dados nativos (use baseados em HTTP ou compatíveis com edge)
• Tarefas de background de longa duração
• WebSocket (limitado nos Workers; use Durable Objects)

Armadilhas

• Usar APIs exclusivas do Node em código compartilhado - quebra nos Workers. Correção: abstrair atrás de adaptadores; usar fetch para I/O.
• Driver PostgreSQL no edge - TCP não está disponível nos Workers. Correção: usar driver serverless Neon, Supabase HTTP ou Prisma Accelerate.
• Assumir CPU ilimitada - Workers têm limites de tempo de CPU. Correção: manter handlers rápidos; descarregar trabalho pesado para filas.
• Variáveis de ambiente diferem - process.env no Node, binding env nos Workers. Correção: passar configuração para createApp(config).
• Sem conexões persistentes no edge - cada requisição é isolada. Correção: usar Durable Objects ou armazenamento de estado externo.
• Testar apenas no Node - surpresas do runtime edge em produção. Correção: testar com wrangler dev ou Miniflare.

Alternativas

FAQs

Relacionado

• Noções Básicas de Hono - começando
• Noções Básicas de Serverless - padrões serverless
• Mitigação de Cold Start - cold starts de edge
• Checklist de Seleção de Framework - matriz completa
• Melhores Práticas de Frameworks Leves - checklist da seção

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.