404 Not Found handler in Express - Mini Project: Build & Apply

Express 404 Not Found Handler

📖 Scenario: You are building a simple Express web server. You want to handle requests to pages that do not exist by showing a friendly 404 Not Found message.

🎯 Goal: Create an Express app that responds with a 404 Not Found message for any request that does not match existing routes.

📋 What You'll Learn

Create an Express app instance

Add a basic route for the home page at '/'

Add a 404 handler middleware that catches all unmatched routes

Send a 404 status and a simple text message '404 Not Found' in the 404 handler

💡 Why This Matters

🌍 Real World

Web servers often need to handle requests to pages that do not exist. Showing a clear 404 Not Found message helps users understand the problem.

💼 Career

Knowing how to add middleware and handle 404 errors is a basic skill for backend developers working with Express or similar web frameworks.

1

Create Express app and home route

Write code to import Express, create an app instance called app, and add a GET route for '/' that sends the text 'Home Page'.

Express

const express = require('express');
const app = express();

// Your code here

Hint

Use express() to create the app. Use app.get for the home route.

2

Add 404 handler middleware

Add a middleware function using app.use that takes req, res, and next parameters. This middleware will handle all unmatched routes.

Express

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Home Page');
});

// Add 404 middleware below
// Your code here

Hint

Use app.use with three parameters to catch all unmatched routes.

3

Set 404 status and send message

Inside the 404 middleware, set the response status to 404 using res.status(404) and send the text '404 Not Found' using res.send.

Express

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Home Page');
});

app.use((req, res, next) => {
  // Set 404 status and send message
  // Your code here
});

Hint

Chain res.status(404) and res.send('404 Not Found') to respond properly.

4

Start the server on port 3000

Add code to start the Express server by calling app.listen on port 3000.

Express

const express = require('express');
const app = express();

app.get('/', (req, res) => {
  res.send('Home Page');
});

app.use((req, res, next) => {
  res.status(404).send('404 Not Found');
});

// Start server on port 3000
// Your code here

Hint

Use app.listen(3000) to start the server.

Practice

1. What is the main purpose of a 404 Not Found handler in an Express app?

easy

A. To catch requests for routes that do not exist and respond with a message

B. To handle database connection errors

C. To log all incoming requests

D. To serve static files like images and CSS

Solution

1. Step 1: Understand what a 404 error means

   A 404 error means the requested page or route was not found on the server.

2. Step 2: Role of the 404 handler in Express

   The 404 handler catches these unknown routes and sends a clear message to the user.

3. Final Answer:

   To catch requests for routes that do not exist and respond with a message -> Option A

4. Quick Check:

   404 handler = catch unknown routes [OK]

Hint: 404 handler catches unknown routes last in middleware [OK]

Common Mistakes:

• Confusing 404 handler with error handler for server errors
• Placing 404 handler before route definitions
• Using 404 handler to serve static files

2. Which of the following is the correct syntax to add a 404 handler in Express?

easy

A. app.route('*').get((req, res) => { res.status(404).send('Not Found'); });

B. app.get('/404', (req, res) => { res.send('Not Found'); });

C. app.use((req, res) => { res.status(404).send('Not Found'); });

D. app.use((err, req, res, next) => { res.status(404).send('Not Found'); });

Solution

1. Step 1: Identify the middleware signature for 404 handler

   A 404 handler uses app.use with (req, res) parameters, no error parameter.

2. Step 2: Check each option's correctness

   app.use((req, res) => { res.status(404).send('Not Found'); }); correctly uses app.use with (req, res) and sets status 404. app.get('/404', (req, res) => { res.send('Not Found'); }); is a route, not a catch-all. app.use((err, req, res, next) => { res.status(404).send('Not Found'); }); is an error handler (has err param). app.route('*').get((req, res) => { res.status(404).send('Not Found'); }); uses app.route('*') which is not standard for 404.

3. Final Answer:

   app.use((req, res) => { res.status(404).send('Not Found'); }); -> Option C

4. Quick Check:

   404 handler = app.use with (req, res) [OK]

Hint: 404 handler uses app.use with (req, res), no error param [OK]

Common Mistakes:

• Using error handler signature (err, req, res, next) for 404
• Defining 404 as a specific route like '/404'
• Using app.route('*') incorrectly for 404

3. Given this Express code snippet, what will the server respond with when a user visits /unknown?

const express = require('express');
const app = express();

app.get('/home', (req, res) => {
  res.send('Welcome Home');
});

app.use((req, res) => {
  res.status(404).send('Page Not Found');
});

app.listen(3000);

medium

A. No response, request hangs

B. 'Welcome Home'

C. Server error 500

D. 'Page Not Found' with status 404

Solution

1. Step 1: Check defined routes

   The only defined route is '/home'. The request is for '/unknown', which is not defined.

2. Step 2: Check 404 handler behavior

   The app.use middleware catches all unmatched routes and sends 'Page Not Found' with status 404.

3. Final Answer:

   'Page Not Found' with status 404 -> Option D

4. Quick Check:

   Unknown route triggers 404 handler [OK]

Hint: Unknown routes trigger 404 handler last middleware [OK]

Common Mistakes:

• Assuming default 200 status for unknown routes
• Expecting server error instead of 404
• Thinking the request will hang without response

4. Identify the error in this Express 404 handler code:

app.use((req, res, next) => {
  res.send('404 Not Found');
  res.status(404);
});

medium

A. The status should be set before sending the response

B. The handler should have four parameters (err, req, res, next)

C. The handler should use res.redirect instead of res.send

D. The middleware should be app.get, not app.use

Solution

1. Step 1: Check order of response methods

   Calling res.send sends the response immediately. Setting status after sending has no effect.

2. Step 2: Correct order for setting status and sending

   Status must be set before res.send to apply correctly.

3. Final Answer:

   The status should be set before sending the response -> Option A

4. Quick Check:

   Set status before send [OK]

Hint: Always set status before sending response [OK]

Common Mistakes:

• Setting status after res.send (ignored)
• Using error handler signature for 404
• Using app.get instead of app.use for 404

5. You want to add a 404 handler that returns JSON with a message and logs the missing URL. Which code correctly implements this in Express?

hard

A. app.use((err, req, res, next) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); });

B. app.use((req, res) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); });

C. app.get('*', (req, res) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); });

D. app.use((req, res, next) => { res.json({ error: 'Not Found' }); console.log('Missing:', req.url); res.status(404); });

Solution

1. Step 1: Choose correct middleware signature for 404 handler

   404 handler uses app.use with (req, res), no error parameter.

2. Step 2: Ensure status is set before sending JSON and logging happens before response

   app.use((req, res) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); }); logs the URL, sets status 404, and sends JSON correctly. app.use((err, req, res, next) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); }); uses error handler signature incorrectly. app.get('*', (req, res) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); }); uses app.get('*') which is less common and may miss some requests. app.use((req, res, next) => { res.json({ error: 'Not Found' }); console.log('Missing:', req.url); res.status(404); }); sets status after sending response and logs after response, which is wrong.

3. Final Answer:

   app.use((req, res) => { console.log('Missing:', req.url); res.status(404).json({ error: 'Not Found' }); }); -> Option B

4. Quick Check:

   404 handler logs then sends JSON with status 404 [OK]

Hint: Use app.use with (req, res), set status before json, log before response [OK]

Common Mistakes:

• Using error handler signature for 404
• Setting status after sending response
• Logging after sending response
• Using app.get('*') instead of app.use