Desarrollo de middleware personalizado para Express
Escriba sus propias funciones de middleware para Express con el fin de ampliar la funcionalidad y agilizar el procesamiento de solicitudes.
Desarrollo de middleware personalizado para Express es una lección gratuita de Node.js Backend Development Bootcamp en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Node.js Backend Development Bootcamp, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Node.js Backend Development Bootcamp incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
What is Custom Middleware?
In Express.js, middleware functions are like a chain of helpers that process incoming requests before they reach your final route handler.
- They have access to the request (
req) and response (res) objects. - They can modify these objects, end the request-response cycle, or pass control to the next middleware.
- Custom middleware allows you to add specific functionality tailored to your application's needs, such as logging, authentication, or data parsing.
The Middleware Signature
Every Express middleware function follows a specific signature: (req, res, next).
req(request): The incoming HTTP request object.res(response): The HTTP response object that Express sends back.next: A function that, when called, passes control to the next middleware function in the stack. If you don't callnext(), the request-response cycle stops, and no further middleware or route handlers will execute.
Your First Logger Middleware
Let's create a simple custom middleware that logs details of every incoming request to the console. This helps in debugging and monitoring.
Try running the code and then accessing http://localhost:3000 in your browser. Check the console output!
const express = require('express');
const app = express();
const port = 3000;
// Custom logging middleware
const requestLogger = (req, res, next) => {
console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
next(); // Pass control to the next middleware/route handler
};
// Apply the custom middleware globally
app.use(requestLogger);
// Define a simple route
app.get('/', (req, res) => {
res.send('Hello from Express!');
});
// Start the server
app.listen(port, () => {
console.log(`Server running at http://localhost:${port}`);
});Applying Middleware: Global vs. Route
You can apply middleware at different levels:
- Globally (Application-level): Using
app.use(middlewareFunction)applies the middleware to ALL incoming requests. - Route-specific: You can apply middleware to specific routes or groups of routes by passing it as an argument before the route handler.
This flexibility allows you to execute logic only where it's needed.
Passing Data Downstream
A powerful feature of middleware is its ability to add properties to the req object. These properties then become accessible to all subsequent middleware functions and the final route handler in the request-response cycle.
This is extremely useful for things like attaching user information after authentication, or parsed data before reaching the main logic.
Example: Attaching User Data
Here's how you might attach a mock user object to the request. In a real application, this data would come from a database or a decoded JSON Web Token (JWT).
Notice how the /profile route handler can directly access req.user because the attachUserInfo middleware ran first.
const express = require('express');
const app = express();
const port = 3000;
// Middleware to attach user info (mock data)
const attachUserInfo = (req, res, next) => {
req.user = { id: '123', name: 'Alice', role: 'admin' };
console.log('User info attached to request.');
next();
};
// Apply the middleware globally
app.use(attachUserInfo);
// Route that uses the attached user info
app.get('/profile', (req, res) => {
res.send(`Welcome, ${req.user.name}! Your role is: ${req.user.role}`);
});
app.get('/', (req, res) => {
res.send('Home page (no user info explicitly needed here)');
});
app.listen(port, () => {
console.log(`Server running at http://localhost:${port}`);
});Building Middleware Chains
You can chain multiple middleware functions together. Express executes them in the order they are defined. Each middleware must call next() to pass control to the next one.
- This allows you to break down complex request processing into smaller, manageable, and reusable functions.
- For example, you could have a middleware for authentication, then one for logging, then one for parsing, all before your final route handler.
Conditional Middleware Execution
Sometimes you only want middleware to run under certain conditions. You can achieve this by:
- Route-specific application: As seen, applying middleware directly to
app.get(),app.post(), etc. - Internal logic: Adding conditional checks (
ifstatements) inside the middleware itself. - Custom wrapper functions: Creating a function that returns a middleware based on parameters.
Practical: Request Timer Middleware
Let's build a middleware that measures how long it takes for a request to be processed and a response to be sent. This is very useful for performance monitoring.
This example uses res.on('finish', ...) to execute code AFTER the response has been sent to the client.
const express = require('express');
const app = express();
const port = 3000;
// Middleware to measure request duration
const requestTimer = (req, res, next) => {
const start = Date.now(); // Record start time
res.on('finish', () => { // Listen for the response 'finish' event
const end = Date.now(); // Record end time
const duration = end - start;
console.log(`${req.method} ${req.originalUrl} took ${duration}ms`);
});
next(); // Pass control
};
// Apply the timer middleware
app.use(requestTimer);
// Define a route that simulates some work
app.get('/slow', (req, res) => {
setTimeout(() => {
res.send('This was a slow response!');
}, 500); // Simulate 500ms delay
});
app.get('/', (req, res) => {
res.send('Hello, fast world!');
});
app.listen(port, () => {
console.log(`Server running at http://localhost:${port}`);
});Middleware Function Quiz
Consider a custom middleware function defined as const myMiddleware = (req, res, next) => { /* ... */ };
Which of the following statements about its behavior is TRUE?
Custom Middleware Recap
You've learned how to create and use custom Express middleware!
- Custom middleware functions have the signature
(req, res, next). - Calling
next()is crucial to pass control to the next middleware or route handler. - Middleware can modify the
reqandresobjects, making data available downstream. - You can apply middleware globally with
app.use()or to specific routes. - They are powerful for adding reusable logic like logging, authentication, or request timing.
Mastering custom middleware is key to building modular and efficient Express applications.
Preguntas frecuentes
¿La lección «Desarrollo de middleware personalizado para Express» es gratis?
Sí — el texto completo de «Desarrollo de middleware personalizado para Express» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Node.js Backend Development Bootcamp, actualiza a CoddyKit PRO. El curso de Node.js Backend Development Bootcamp incluye 4 lecciones en total.
¿Qué aprenderé en «Desarrollo de middleware personalizado para Express»?
Escriba sus propias funciones de middleware para Express con el fin de ampliar la funcionalidad y agilizar el procesamiento de solicitudes. Practicas Node.js Backend Development Bootcamp con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Node.js Backend Development Bootcamp?
No se requiere experiencia previa. Node.js Backend Development Bootcamp en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Desarrollo de middleware personalizado para Express»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Node.js Backend Development Bootcamp?
Sí. Cada lección de Node.js Backend Development Bootcamp incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Desarrollo de middleware personalizado para Express
- Estrategias globales de gestión de errores
- Validación de entradas con Joi/Express-Validator
- Middleware de autenticación con JWT