express-global-error

A simple and lightweight global error handling middleware for Express.js applications.
It helps you standardize error responses, catch async errors, and propagate meaningful messages to clients without repeating boilerplate code.

---

✨ Features

- Centralized error handling for Express
- Custom AppError class for structured errors
- Middleware errorHandler for formatting and sending errors
- Utility asyncHandler to wrap async functions
- Easy integration with existing Express apps
- Works with TypeScript and JavaScript

---

📦 Installation

``bash
npm install express-global-error
`

How to use this package?

`JS
// import your package
import { AppError, errorHandler, asyncHandler } from "express-global-error";
`

Create routes with AppError

`JS
app.get("/fail", (req, res, next) => {
// throw a custom error
next(new AppError("Resource not found", 404));
});
`

Use asyncHandler for async routes

`JS
app.get("/async-fail", asyncHandler(async (req, res, next) => {
throw new AppError("Async operation failed", 500);
}));
`

Register global error handler (last middleware)

`JS
app.use(errorHandler);

app.listen(3000, () => {
console.log("Server running on port 3000");
});
`


Example Response

$3

`JS
{
"status": "error",
"statusCode": 404,
"message": "User not found"
}
``

API Reference

class AppError(message: string, statusCode: number)
Creates a new structured error
message → error message
statusCode → HTTP status code (e.g., 400, 404, 500)
errorHandler(err, req, res, next)
Express middleware to catch and send error responses asyncHandler(fn)
Wraps async route handlers and automatically forwards errors to errorHandler