Express 5 vs Fastify Comparación

// Express 5 - Handler async + captura automática de errores
import express from 'express';

const app = express();
app.use(express.json());

// Clase de error simple — para un mensaje claro en el límite de la API
class NotFoundError extends Error {
  status = 404;
}

async function getUser(id) {
  const user = await db.users.findById(id);
  if (!user) throw new NotFoundError('User not found');
  return user;
}

// Express 5: si el handler async rechaza o lanza, next(err) se llama automáticamente.
// No olvides hacer return del Promise — si no, el rejection puede quedar unhandled.
app.get('/api/users/:id', async (req, res) => {
  const user = await getUser(req.params.id);
  res.json(user);
});

// Middleware de error centralizado — se añade al final de la pila global
app.use((err, req, res, next) => {
  const status = err.status ?? 500;
  res.status(status).json({ error: err.message });
});

app.listen(3000, () => {
  console.log('Express server listening on port 3000');
});

// Fastify 5 - Validación por esquema + serialización automática
import Fastify from 'fastify';

const fastify = Fastify({ logger: true });

// Esquema de respuesta: fast-json-stringify genera a partir de este esquema
// una función de serialización — más rápida que un JSON.stringify genérico.
const userSchema = {
  type: 'object',
  properties: {
    id: { type: 'string' },
    name: { type: 'string' },
    email: { type: 'string' },
  },
  required: ['id', 'name', 'email'],
};

const getUserOpts = {
  schema: {
    params: {
      type: 'object',
      properties: { id: { type: 'string' } },
      required: ['id'],
    },
    response: {
      200: userSchema,
    },
  },
};

// Encapsulation: los hooks/decorators registrados dentro de este plugin
// solo afectan a las rutas de este context.
fastify.register(async function userRoutes(instance) {
  instance.get('/api/users/:id', getUserOpts, async (request, reply) => {
    const user = await db.users.findById(request.params.id);
    if (!user) {
      return reply.code(404).send({ error: 'User not found' });
    }
    request.log.info({ userId: user.id }, 'user fetched');
    return user;
  });
});

fastify.setErrorHandler((error, request, reply) => {
  reply.status(error.statusCode ?? 500).send({ error: error.message });
});

await fastify.listen({ port: 3000 });