Middleware concept and execution flow in Node.js

Introduction

Middleware helps your app handle requests step-by-step. It lets you add features like logging or checking users before doing the main work.

You want to log every request to see who visits your site.

You need to check if a user is logged in before showing a page.

You want to handle errors in one place instead of everywhere.

You want to add data to requests that later parts of your app can use.

Syntax

Node.js

app.use(function (req, res, next) {
  // your code here
  next();
});

Middleware functions get three things: request (req), response (res), and next function.

Call next() to move to the next middleware or route handler.

Examples

This middleware logs the URL of every request before moving on.

Node.js

app.use(function (req, res, next) {
  console.log('Request URL:', req.url);
  next();
});

This middleware checks if the user is logged in. If not, it stops and sends a message.

Node.js

app.use(function (req, res, next) {
  if (!req.user) {
    res.status(401).send('Please log in');
  } else {
    next();
  }
});

This is error-handling middleware. It catches errors and sends a message.

Node.js

app.use(function (err, req, res, next) {
  console.error(err.stack);
  res.status(500).send('Something broke!');
});

Sample Program

This program uses two middleware functions. The first logs the request method and URL. The second adds a message to the request. The route then sends that message back to the browser.

Node.js

import express from 'express';
const app = express();

// Middleware to log request method and URL
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`);
  next();
});

// Middleware to add a custom property
app.use((req, res, next) => {
  req.customMessage = 'Hello from middleware!';
  next();
});

// Route handler
app.get('/', (req, res) => {
  res.send(req.customMessage);
});

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

Important Notes

Always call next() unless you send a response to avoid hanging requests.

Middleware runs in the order you add it with app.use().

Error-handling middleware has four arguments: (err, req, res, next).

Summary

Middleware lets you run code on requests before reaching routes.

Use next() to pass control to the next middleware.

Order matters: middleware runs in the order you add it.

Practice

1. What is the main purpose of middleware in a Node.js Express app?

easy

A. To style the HTML pages

B. To directly send responses to the client without routes

C. To define database schemas

D. To run code on requests before they reach the route handlers

Solution

1. Step 1: Understand middleware role and compare options

   Middleware functions run before route handlers to process requests. Only To run code on requests before they reach the route handlers describes middleware's role correctly; others describe unrelated tasks.

2. Final Answer:

   To run code on requests before they reach the route handlers -> Option D

3. Quick Check:

   Middleware = Pre-route code [OK]

Hint: Middleware runs before routes to handle requests [OK]

Common Mistakes:

• Thinking middleware sends responses directly
• Confusing middleware with database logic
• Assuming middleware styles pages

2. Which of the following is the correct way to define a middleware function in Express?

easy

A. app.get((req, res) => { console.log('Middleware'); });

B. app.use((req, res, next) => { console.log('Middleware'); next(); });

C. app.middleware((req, res, next) => { next(); });

D. app.route('/').middleware((req, res) => { next(); });

Solution

1. Step 1: Recall Express middleware syntax and check options

   Middleware uses app.use() with (req, res, next) parameters. Only app.use((req, res, next) => { console.log('Middleware'); next(); }); uses app.use() and calls next(), which is correct middleware syntax.

2. Final Answer:

   app.use((req, res, next) => { console.log('Middleware'); next(); }); -> Option B

3. Quick Check:

   Middleware = app.use + next() [OK]

Hint: Middleware uses app.use and calls next() [OK]

Common Mistakes:

• Using app.get instead of app.use for middleware
• Missing next() call inside middleware
• Using non-existent app.middleware method

3. Consider this Express code:

app.use((req, res, next) => { console.log('First'); next(); });
app.use((req, res, next) => { console.log('Second'); next(); });
app.get('/', (req, res) => { res.send('Done'); });

What will be printed in the console when a GET request is made to '/'?

medium

A. First\nSecond

B. Second\nFirst

C. Done

D. No output

Solution

1. Step 1: Understand middleware execution order and route handler

   Middleware runs in the order added: first prints 'First', then calls next(), second prints 'Second'. After middleware, route handler sends response but does not print to console.

2. Final Answer:

   First\nSecond -> Option A

3. Quick Check:

   Middleware order = console logs order [OK]

Hint: Middleware logs appear in order added before route runs [OK]

Common Mistakes:

• Assuming route handler logs to console
• Thinking middleware runs in reverse order
• Missing next() causes no further logs

4. What is the problem with this middleware code?

app.use((req, res, next) => { console.log('Start'); });
app.get('/', (req, res) => { res.send('Hello'); });

medium

A. It calls next() twice, causing an error

B. It sends response twice, causing an error

C. It never calls next(), so the request hangs

D. It uses wrong parameters in middleware function

Solution

1. Step 1: Check middleware function and request flow effect

   The middleware logs 'Start' but does not call next(), so it blocks further processing. Without next(), the route handler never runs, so the request hangs.

2. Final Answer:

   It never calls next(), so the request hangs -> Option C

3. Quick Check:

   Missing next() blocks request [OK]

Hint: Always call next() in middleware unless sending response [OK]

Common Mistakes:

• Forgetting to call next() in middleware
• Calling next() multiple times
• Confusing middleware parameters

5. You want to add two middleware functions to log request time and check authentication before handling routes. Which code correctly ensures both run in order and the route handler executes after?

hard

A. app.use((req, res, next) => { console.log('Time:', Date.now()); next(); });\napp.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });\napp.get('/', (req, res) => { res.send('Welcome'); });

B. app.use((req, res) => { console.log('Time:', Date.now()); });\napp.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });\napp.get('/', (req, res) => { res.send('Welcome'); });

C. app.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });\napp.use((req, res, next) => { console.log('Time:', Date.now()); next(); });\napp.get('/', (req, res) => { res.send('Welcome'); });

D. app.get('/', (req, res) => { console.log('Time:', Date.now()); });\napp.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });

Solution

1. Step 1: Check middleware order, next() calls, and route handler execution

   app.use((req, res, next) => { console.log('Time:', Date.now()); next(); });\napp.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });\napp.get('/', (req, res) => { res.send('Welcome'); }); runs time logger first, calls next(), then auth check middleware, which calls next() or sends response. Only if both middleware call next(), the route handler runs and sends 'Welcome'.

2. Final Answer:

   app.use((req, res, next) => { console.log('Time:', Date.now()); next(); });\napp.use((req, res, next) => { if(req.user) next(); else res.status(401).send('Unauthorized'); });\napp.get('/', (req, res) => { res.send('Welcome'); }); -> Option A

3. Quick Check:

   Middleware order + next() = correct flow [OK]

Hint: Middleware must call next() to continue chain in correct order [OK]

Common Mistakes:

• Missing next() in first middleware
• Reversing middleware order
• Using app.get instead of app.use for middleware