Async error handling in routes in Express

Introduction

Async error handling helps catch problems in routes that use asynchronous code, so your app doesn't crash and can respond properly.

When your route handler uses async/await to fetch data from a database.

When calling external APIs inside a route that might fail.

When performing file operations asynchronously in a route.

When you want to keep your app stable by catching errors in async code.

When you want to send meaningful error messages to users if something goes wrong.

Syntax

Express

app.get('/route', async (req, res, next) => {
  try {
    // async code here
    res.send(result);
  } catch (error) {
    next(error); // pass error to Express error handler
  }
});

Use try/catch inside async route handlers to catch errors.

Call next(error) to let Express handle the error properly.

Examples

Fetch a user asynchronously and handle errors by passing them to Express.

Express

app.get('/user/:id', async (req, res, next) => {
  try {
    const user = await getUserById(req.params.id);
    res.json(user);
  } catch (err) {
    next(err);
  }
});

Save data asynchronously and send a 201 status on success, or pass errors on failure.

Express

app.post('/data', async (req, res, next) => {
  try {
    const saved = await saveData(req.body);
    res.status(201).send(saved);
  } catch (error) {
    next(error);
  }
});

Sample Program

This Express app has a route that fetches data asynchronously. If the ID is '0', it throws an error. The error is caught and passed to the error handler, which sends a 500 status with the error message.

Express

import express from 'express';
const app = express();
app.use(express.json());

// Simulated async function that may throw
async function fetchData(id) {
  if (id === '0') throw new Error('Invalid ID');
  return { id, name: 'Item ' + id };
}

app.get('/item/:id', async (req, res, next) => {
  try {
    const data = await fetchData(req.params.id);
    res.json(data);
  } catch (error) {
    next(error);
  }
});

// Error handler middleware
app.use((err, req, res, next) => {
  res.status(500).json({ error: err.message });
});

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

Important Notes

Always use next(error) in async routes to avoid unhandled promise rejections.

Express error handler middleware must have four parameters: (err, req, res, next).

Without proper async error handling, your server might crash or hang on errors.

Summary

Use try/catch blocks in async route handlers to catch errors.

Pass errors to Express with next(error) for centralized handling.

Set up an error handler middleware to send user-friendly error responses.

Practice

1. What is the main reason to use try/catch blocks inside async route handlers in Express?

easy

A. To automatically retry failed requests

B. To catch errors from asynchronous code and pass them to Express error handlers

C. To make the route handler run faster

D. To prevent the server from starting

Solution

1. Step 1: Understand async errors in Express routes

   Async functions can throw errors that are not caught automatically by Express, so we need to catch them manually.

2. Step 2: Use try/catch to handle errors

   Wrapping async code in try/catch allows catching errors and passing them to Express with next(error).

3. Final Answer:

   To catch errors from asynchronous code and pass them to Express error handlers -> Option B

4. Quick Check:

   try/catch in async routes = catch async errors [OK]

Hint: Use try/catch to catch async errors and call next(error) [OK]

Common Mistakes:

• Ignoring errors in async functions
• Not calling next(error) inside catch
• Assuming Express catches async errors automatically

2. Which of the following is the correct syntax to pass an error to the next middleware in an async Express route?

easy

A. res.send(error)

B. throw error

C. return error

D. next(error)

Solution

1. Step 1: Identify how Express handles errors

   Express expects errors to be passed to the next middleware using next(error).

2. Step 2: Confirm correct syntax in async routes

   Inside a catch block, calling next(error) forwards the error to the error handler middleware.

3. Final Answer:

   next(error) -> Option D

4. Quick Check:

   Pass errors with next(error) [OK]

Hint: Use next(error) to forward errors in Express [OK]

Common Mistakes:

• Using throw instead of next(error) inside async catch
• Returning error instead of passing to next
• Sending error directly with res.send inside catch

3. Consider this Express route handler:

app.get('/data', async (req, res, next) => {
  try {
    const result = await fetchData();
    res.json(result);
  } catch (error) {
    next(error);
  }
});

What happens if fetchData() throws an error?

medium

A. The error is caught and passed to the next error handler middleware

B. The server crashes immediately

C. The request hangs without response

D. The error is ignored and response is sent anyway

Solution

1. Step 1: Analyze the try/catch block

   If fetchData() throws, the catch block runs and calls next(error).

2. Step 2: Understand Express error flow

   Calling next(error) sends the error to Express error handler middleware, preventing crashes or hanging.

3. Final Answer:

   The error is caught and passed to the next error handler middleware -> Option A

4. Quick Check:

   Errors in try/catch + next(error) = handled error [OK]

Hint: Errors in async try/catch go to next(error) middleware [OK]

Common Mistakes:

• Assuming server crashes on async error
• Thinking response is sent despite error
• Not using next(error) to handle errors

4. Identify the error in this async Express route handler:

app.get('/user', async (req, res, next) => {
  const user = await getUser();
  res.json(user);
});

What is the problem with this code regarding error handling?

medium

A. It sends response twice

B. It incorrectly uses next() inside the route

C. It lacks a try/catch block to handle errors from the async function

D. It uses synchronous code inside async function

Solution

1. Step 1: Check for error handling in async code

   The async function getUser() might throw errors, but no try/catch is used.

2. Step 2: Understand Express error propagation

   Without try/catch and calling next(error), errors will not be handled properly and may crash the server.

3. Final Answer:

   It lacks a try/catch block to handle errors from the async function -> Option C

4. Quick Check:

   Async routes need try/catch for error handling [OK]

Hint: Always wrap async code in try/catch to handle errors [OK]

Common Mistakes:

• Omitting try/catch in async route handlers
• Expecting Express to catch async errors automatically
• Not calling next(error) inside catch

5. You want to create a centralized error handler middleware in Express that catches all errors passed by next(error). Which of the following is the correct way to define this middleware?

hard

A. app.use((err, req, res, next) => { res.status(500).json({ message: err.message }); });

B. app.use((req, res, next) => { res.status(500).send('Error'); });

C. app.get('/error', (err, req, res) => { res.send(err); });

D. app.use((err, req, res) => { res.json({ error: err }); });

Solution

1. Step 1: Recall Express error handler signature

   Error handlers must have four parameters: (err, req, res, next).

2. Step 2: Check each option for correct signature and response

   app.use((err, req, res, next) => { res.status(500).json({ message: err.message }); }); uses all four parameters and sends JSON with error message and status 500, which is correct.

3. Final Answer:

   app.use((err, req, res, next) => { res.status(500).json({ message: err.message }); }); -> Option A

4. Quick Check:

   Error handler middleware = 4 params + send error response [OK]

Hint: Error middleware needs 4 params: err, req, res, next [OK]

Common Mistakes:

• Missing the 'next' parameter in error middleware
• Using app.get instead of app.use for error handler
• Not setting status code in error response