Node.js Backend Development Bootcamp · Aula

Desenvolvimento de Middleware Personalizado para Express

Escreva as suas próprias funções middleware do Express para ampliar a funcionalidade e simplificar o processamento de pedidos.

Desenvolvimento de Middleware Personalizado para Express é uma aula grátis de Node.js Backend Development Bootcamp no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Node.js Backend Development Bootcamp, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Node.js Backend Development Bootcamp inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em 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 call next(), 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 (if statements) 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 req and res objects, 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.

Perguntas Frequentes

A aula “Desenvolvimento de Middleware Personalizado para Express” é grátis?

Sim — o texto completo de “Desenvolvimento de Middleware Personalizado para Express” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Node.js Backend Development Bootcamp, atualize para CoddyKit PRO. O curso de Node.js Backend Development Bootcamp inclui 4 aulas no total.

O que vou aprender em “Desenvolvimento de Middleware Personalizado para Express”?

Escreva as suas próprias funções middleware do Express para ampliar a funcionalidade e simplificar o processamento de pedidos. Você pratica Node.js Backend Development Bootcamp com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Node.js Backend Development Bootcamp?

Nenhuma experiência prévia é necessária. Node.js Backend Development Bootcamp no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Desenvolvimento de Middleware Personalizado para Express”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Node.js Backend Development Bootcamp?

Sim. Cada aula de Node.js Backend Development Bootcamp inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

Desenvolvimento de Middleware Personalizado para Express
Estratégias Globais de Tratamento de Erros
Validação de Dados de Entrada com Joi/Express-Validator
Middleware de autenticação com JWT

← Voltar para Node.js Backend Development Bootcamp