Conceptos básicos de Hono

Q: ¿Hono funciona en Node 24?

Sí, a través de @hono/node-server. El mismo código Hono puede desplegarse en Cloudflare Workers.

10 ejemplos para construir APIs con Hono en Node.js - 7 básicos y 3 intermedios.

Prerrequisitos

mkdir hono-api && cd hono-api
npm init -y
npm pkg set type=module
npm install hono @hono/node-server
npm install -D typescript@5.6 tsx

Para decisiones de portabilidad en tiempo de ejecución, consulta Hono en Node vs Edge.

Ejemplos básicos

1. Hola Mundo en Node

import { Hono } from "hono";
import { serve } from "@hono/node-server";
 
const app = new Hono();
 
app.get("/", (c) => c.text("Hello from Hono\n"));
 
serve({ fetch: app.fetch, port: 3000 });

c es el objeto Contexto con helpers para tipos de respuesta
app.fetch es un manejador fetch estándar web
@hono/node-server conecta Hono con Node HTTP

2. Respuesta JSON

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users", (c) => {
  return c.json([{ id: 1, name: "Ada Lovelace" }]);
});

c.json() establece Content-Type: application/json
Devuelve la Respuesta directamente desde los manejadores

3. Parámetros de ruta y consulta

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  const include = c.req.query("include");
  return c.json({ id, include });
});

c.req.param() para parámetros de ruta
c.req.query() para cadenas de consulta

4. POST con cuerpo JSON

import { Hono } from "hono";
 
const app = new Hono();
 
app.post("/users", async (c) => {
  const body = await c.req.json<{ name: string; email: string }>();
  return c.json({ id: "1", ...body }, 201);
});

c.req.json() analiza el cuerpo de forma asíncrona
Código de estado como segundo argumento de c.json()

5. Middleware

import { Hono } from "hono";
import { logger } from "hono/logger";
 
const app = new Hono();
 
app.use("*", logger());
app.use("/api/*", async (c, next) => {
  const start = Date.now();
  await next();
  c.header("X-Response-Time", `${Date.now() - start}ms`);
});

app.use(path, middleware) para middleware con ámbito de ruta
await next() para continuar la cadena
Middleware logger() incorporado para el registro de solicitudes

6. Grupos de rutas

import { Hono } from "hono";
 
const users = new Hono();
users.get("/", (c) => c.json([]));
users.get("/:id", (c) => c.json({ id: c.req.param("id") }));
 
const app = new Hono();
app.route("/users", users);

app.route(prefix, subApp) monta grupos de rutas
Cada sub-aplicación es una instancia independiente de Hono

7. Manejo de errores

import { Hono } from "hono";
import { HTTPException } from "hono/http-exception";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  if (id === "999") throw new HTTPException(404, { message: "Not found" });
  return c.json({ id });
});
 
app.onError((err, c) => {
  if (err instanceof HTTPException) {
    return c.json({ error: err.message }, err.status);
  }
  return c.json({ error: "Internal server error" }, 500);
});

HTTPException para errores operativos con códigos de estado
app.onError() para el manejo centralizado de errores

Ejemplos intermedios

8. Variables de contexto tipadas

import { Hono } from "hono";
import { createMiddleware } from "hono/factory";
 
type Variables = { userId: string };
 
const app = new Hono<{ Variables: Variables }>();
 
const auth = createMiddleware<{ Variables: Variables }>(async (c, next) => {
  c.set("userId", "user-42");
  await next();
});
 
app.use("/api/*", auth);
app.get("/api/me", (c) => c.json({ userId: c.get("userId") }));

Tipo genérico Variables para c.set() / c.get()
createMiddleware para fábricas de middleware tipadas

9. CORS y seguridad

import { Hono } from "hono";
import { cors } from "hono/cors";
import { secureHeaders } from "hono/secure-headers";
 
const app = new Hono();
app.use("*", cors({ origin: "https://app.example.com" }));
app.use("*", secureHeaders());

Middleware de CORS y encabezados de seguridad incorporados
No se necesita una dependencia externa de helmet

10. Validación con Zod

import { Hono } from "hono";
import { zValidator } from "@hono/zod-validator";
import { z } from "zod";
 
const app = new Hono();
 
const schema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
});
 
app.post("/users", zValidator("json", schema), (c) => {
  const body = c.req.valid("json");
  return c.json({ id: "1", ...body }, 201);
});

@hono/zod-validator integra Zod con Hono
c.req.valid("json") devuelve datos tipados y validados

Preguntas frecuentes

¿Cuándo debería elegir Hono en lugar de Express o Fastify?

Hono para portabilidad en el edge, huella diminuta o alineación con los estándares web. Express/Fastify para un ecosistema Node más grande. Consulta Lista de verificación de selección de framework.

¿Hono funciona en Node 24?

Sí, a través de @hono/node-server. El mismo código Hono puede desplegarse en Cloudflare Workers.

¿Hono está listo para producción?

Sí. Se utiliza en producción en Cloudflare Workers y Node. Ecosistema más pequeño que Express/Fastify.

¿Cómo se compara Hono en tamaño?

~14KB minificado frente a Express ~200KB+ con middleware. Importa para los arranques en frío del edge.

¿Puedo usar Hono con TypeScript?

Soporte de TypeScript de primera clase con contexto tipado, validadores y parámetros de ruta.

Relacionado

Hono en Node vs Edge - ADR de tiempo de ejecución
Koa & Polka - otras opciones ligeras
Conceptos básicos de Express - alternativa principal
Lista de verificación de selección de framework - matriz de decisión
Mejores prácticas de frameworks ligeros - lista de verificación de la sección

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Prerrequisitos

mkdir hono-api && cd hono-api
npm init -y
npm pkg set type=module
npm install hono @hono/node-server
npm install -D typescript@5.6 tsx

Para decisiones de portabilidad en tiempo de ejecución, consulta Hono en Node vs Edge.

Ejemplos básicos

1. Hola Mundo en Node

import { Hono } from "hono";
import { serve } from "@hono/node-server";
 
const app = new Hono();
 
app.get("/", (c) => c.text("Hello from Hono\n"));
 
serve({ fetch: app.fetch, port: 3000 });

c es el objeto Contexto con helpers para tipos de respuesta
app.fetch es un manejador fetch estándar web
@hono/node-server conecta Hono con Node HTTP

2. Respuesta JSON

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users", (c) => {
  return c.json([{ id: 1, name: "Ada Lovelace" }]);
});

c.json() establece Content-Type: application/json
Devuelve la Respuesta directamente desde los manejadores

3. Parámetros de ruta y consulta

import { Hono } from "hono";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  const include = c.req.query("include");
  return c.json({ id, include });
});

c.req.param() para parámetros de ruta
c.req.query() para cadenas de consulta

4. POST con cuerpo JSON

import { Hono } from "hono";
 
const app = new Hono();
 
app.post("/users", async (c) => {
  const body = await c.req.json<{ name: string; email: string }>();
  return c.json({ id: "1", ...body }, 201);
});

c.req.json() analiza el cuerpo de forma asíncrona
Código de estado como segundo argumento de c.json()

5. Middleware

import { Hono } from "hono";
import { logger } from "hono/logger";
 
const app = new Hono();
 
app.use("*", logger());
app.use("/api/*", async (c, next) => {
  const start = Date.now();
  await next();
  c.header("X-Response-Time", `${Date.now() - start}ms`);
});

app.use(path, middleware) para middleware con ámbito de ruta
await next() para continuar la cadena
Middleware logger() incorporado para el registro de solicitudes

6. Grupos de rutas

import { Hono } from "hono";
 
const users = new Hono();
users.get("/", (c) => c.json([]));
users.get("/:id", (c) => c.json({ id: c.req.param("id") }));
 
const app = new Hono();
app.route("/users", users);

app.route(prefix, subApp) monta grupos de rutas
Cada sub-aplicación es una instancia independiente de Hono

7. Manejo de errores

import { Hono } from "hono";
import { HTTPException } from "hono/http-exception";
 
const app = new Hono();
 
app.get("/users/:id", (c) => {
  const id = c.req.param("id");
  if (id === "999") throw new HTTPException(404, { message: "Not found" });
  return c.json({ id });
});
 
app.onError((err, c) => {
  if (err instanceof HTTPException) {
    return c.json({ error: err.message }, err.status);
  }
  return c.json({ error: "Internal server error" }, 500);
});

HTTPException para errores operativos con códigos de estado
app.onError() para el manejo centralizado de errores

Ejemplos intermedios

8. Variables de contexto tipadas

import { Hono } from "hono";
import { createMiddleware } from "hono/factory";
 
type Variables = { userId: string };
 
const app = new Hono<{ Variables: Variables }>();
 
const auth = createMiddleware<{ Variables: Variables }>(async (c, next) => {
  c.set("userId", "user-42");
  await next();
});
 
app.use("/api/*", auth);
app.get("/api/me", (c) => c.json({ userId: c.get("userId") }));

Tipo genérico Variables para c.set() / c.get()
createMiddleware para fábricas de middleware tipadas

9. CORS y seguridad

import { Hono } from "hono";
import { cors } from "hono/cors";
import { secureHeaders } from "hono/secure-headers";
 
const app = new Hono();
app.use("*", cors({ origin: "https://app.example.com" }));
app.use("*", secureHeaders());

Middleware de CORS y encabezados de seguridad incorporados
No se necesita una dependencia externa de helmet

10. Validación con Zod

import { Hono } from "hono";
import { zValidator } from "@hono/zod-validator";
import { z } from "zod";
 
const app = new Hono();
 
const schema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
});
 
app.post("/users", zValidator("json", schema), (c) => {
  const body = c.req.valid("json");
  return c.json({ id: "1", ...body }, 201);
});

@hono/zod-validator integra Zod con Hono
c.req.valid("json") devuelve datos tipados y validados

Preguntas frecuentes

¿Cuándo debería elegir Hono en lugar de Express o Fastify?

¿Hono funciona en Node 24?

Sí, a través de @hono/node-server. El mismo código Hono puede desplegarse en Cloudflare Workers.

¿Hono está listo para producción?

Sí. Se utiliza en producción en Cloudflare Workers y Node. Ecosistema más pequeño que Express/Fastify.

¿Cómo se compara Hono en tamaño?

~14KB minificado frente a Express ~200KB+ con middleware. Importa para los arranques en frío del edge.

¿Puedo usar Hono con TypeScript?

Soporte de TypeScript de primera clase con contexto tipado, validadores y parámetros de ruta.

Relacionado

Hono en Node vs Edge - ADR de tiempo de ejecución
Koa & Polka - otras opciones ligeras
Conceptos básicos de Express - alternativa principal
Lista de verificación de selección de framework - matriz de decisión
Mejores prácticas de frameworks ligeros - lista de verificación de la sección

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Conceptos básicos de Hono

Buscar en la documentación

Conceptos básicos de Hono