Node.js Backend Development Bootcamp · Lesson

Developing Custom Express Middleware

Write your own Express middleware functions to extend functionality and streamline request processing.

Developing Custom Express Middleware is a free Node.js Backend Development Bootcamp lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Node.js Backend Development Bootcamp learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

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.

Frequently asked questions

Is the “Developing Custom Express Middleware” lesson free?

Yes — the full text of “Developing Custom Express Middleware” is free to read here on the web, and the Node.js Backend Development Bootcamp course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Node.js Backend Development Bootcamp course, upgrade to CoddyKit PRO.

What will I learn in “Developing Custom Express Middleware”?

Write your own Express middleware functions to extend functionality and streamline request processing. You practise Node.js Backend Development Bootcamp with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Node.js Backend Development Bootcamp?

No prior experience is required. Node.js Backend Development Bootcamp on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Developing Custom Express Middleware” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Node.js Backend Development Bootcamp lesson?

Yes. Every Node.js Backend Development Bootcamp lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

Developing Custom Express Middleware
Global Error Handling Strategies
Input Validation with Joi/Express-Validator
Authentication Middleware with JWT

← Back to Node.js Backend Development Bootcamp