Koa y Polka

Comprende Koa y Polka como frameworks HTTP ligeros de Node que puedes encontrar en bases de código heredadas o despliegues mínimos.

Receta

Referencia rápida para reconocer cada framework.

Koa (contexto asíncrono):

import Koa from "koa";
 
const app = new Koa();
app.use(async (ctx, next) => {
  const start = Date.now();
  await next();
  ctx.set("X-Response-Time", `${Date.now() - start}ms`);
});
app.use(async (ctx) => {
  ctx.body = { ok: true };
});
app.listen(3000);

Polka (router mínimo):

import polka from "polka";
 
const app = polka();
app.get("/users", (_req, res) => {
  res.writeHead(200, { "Content-Type": "application/json" });
  res.end(JSON.stringify([{ id: 1 }]));
});
app.listen(3000);

Cuándo usarlo: Mantener aplicaciones Koa heredadas, o cuando necesites el router HTTP más pequeño posible (Polka).

Ejemplo de trabajo

Comparación lado a lado del mismo endpoint:

// --- Koa ---
import Koa from "koa";
import Router from "@koa/router";
import bodyParser from "koa-bodyparser";
 
const koaApp = new Koa();
const router = new Router({ prefix: "/api" });
 
koaApp.use(bodyParser());
router.get("/users/:id", async (ctx) => {
  ctx.body = { id: ctx.params.id, name: "Ada" };
});
koaApp.use(router.routes());
 
// --- Polka ---
import polka from "polka";
import { json } from "body-parser";
 
const polkaApp = polka();
polkaApp.use(json());
polkaApp.get("/api/users/:id", (req, res) => {
  const id = (req as { params: { id: string } }).params.id;
  res.end(JSON.stringify({ id, name: "Ada" }));
});
 
// --- Equivalente moderno: Hono ---
import { Hono } from "hono";
const honoApp = new Hono();
honoApp.get("/api/users/:id", (c) => c.json({ id: c.req.param("id"), name: "Ada" }));

Lo que esto demuestra:

• Koa usa ctx (contexto) en lugar de (req, res)
• El middleware de Koa es asíncrono primero (sin callback next())
• Polka es un router mínimo sobre HTTP nativo de Node
• Hono proporciona una alternativa moderna con una huella similar

Análisis profundo

Comparación de frameworks

Cuándo aún ves Koa

• APIs de Node más antiguas construidas por equipos que migraron de Express a Koa (~2015-2020)
• Proyectos que usan @koa/router, koa-bodyparser, koa-jwt
• Frameworks construidos sobre Koa (por ejemplo, algunos servidores GraphQL)

Cuándo aún ves Polka

• Microservicios que necesitan la capa HTTP más pequeña posible
• Incluido en herramientas como sirv-cli y los internos del adaptador @sveltejs/kit
• Servicios internos sensibles al rendimiento con menos de 5 rutas

Errores comunes

• Empezar nuevos proyectos con Koa - el ecosistema se está reduciendo. Solución: usa Hono o Fastify para nuevos trabajos.
• Koa sin middleware de errores - los errores asíncronos pueden perderse. Solución: usa try/catch o koa-error-handler.
• Polka sin body parser - los cuerpos POST no se pueden leer. Solución: añade el middleware body-parser.
• Ninguno tiene validación incorporada - manual o añade Zod/Ajv. Solución: usa Hono con @hono/zod-validator.
• Migrar Koa a Hono - conceptos de middleware similares pero API diferente. Solución: reescribe las rutas; los patrones de middleware se transfieren.
• Asumir que Polka tiene un ecosistema - es solo un router. Solución: trae tu propia pila de middleware.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de Hono - alternativa ligera moderna
• Patrón de Middleware - conceptos de middleware
• Enrutamiento sin frameworks - minimalismo a nivel de Polka
• Lista de verificación para la selección de frameworks - matriz de decisión
• Mejores prácticas para 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.