Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
nextjs-exception-middleware
Advanced tools
Readme
This middleware allows you to throw exceptions in your route handlers that are caught and returned as JSON.
For example,
// Inside a route handler
if (bad_soups.includes(soup_param)) {
throw new BadRequestException({
type: "cant_make_soup",
message: "Soup was too difficult, please specify a different soup",
data: { soup_param }
})
}
will be returned as
{
"error": {
"type": "cant_make_soup",
"message": "Soup was too difficult, please specify a different soup",
"data": {
"soup_param": "tomato"
}
}
}
with a status code of 400.
yarn add nextjs-exception-middleware
or npm install nextjs-exception-middleware -s
Wrap your API handlers like so:
import { withExceptionHandling } from "nextjs-exception-middleware"
export default withExceptionHandling({
// all parameters are optional
addOkStatus: false // add top-level "ok" status key to JSON responses
okStatusOptions: {
addIf: (req) => req.method === "GET" // only add "ok" status key if request is GET
},
exceptionHandlingOptions: {
getErrorContext: (req, errorContext) => {
// add any additional context to returned errors
errorContext.request_id = req.requestId
// delete error stack
delete errorContext.stack
return errorContext
}
}
})(async (req, res) => {
// ...
})
HttpException
Use HttpException
to throw any HTTP exception providing the appropriate status code.
import { HttpException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new HttpException(403, {
type: "access_forbidden",
message: "No rights to access the content",
data: { client_id }
})
}
BadRequestException
Use BadRequestException
to respond with 400 Bad Request
status code.
import { BadRequestException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new BadRequestException({
type: "bad_request",
message: "Request cannot be processed due to malformed request syntax"
})
}
UnauthorizedException
Use UnauthorizedException
to respond with 401 Unauthorized
status code.
import { UnauthorizedException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new UnauthorizedException({
type: "unauthorized",
message: "Authenticate yourself to get the requested response",
data: { client_id }
})
}
NotFoundException
Use NotFoundException
to respond with 404 Not Found
status code.
import { NotFoundException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new NotFoundException({
type: "not_found",
message: "The requested resource not found",
data: { resource_id }
})
}
MethodNotAllowedException
Use MethodNotAllowedException
to respond with 405 Method Not Allowed
status code.
import { MethodNotAllowedException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new MethodNotAllowedException({
type: "method_not_allowed",
message: "Request method ${req.method} is not allowed"
})
}
InternalServerErrorException
Use InternalServerErrorException
to respond with 500 Internal Server Error
status code.
import { InternalServerErrorException } from "nextjs-exception-middleware"
export default (req, res) => {
/* ... */
throw new InternalServerErrorException({
type: "server_error",
message: "Internal server error occurred"
})
}
FAQs
This middleware allows you to throw exceptions in your route handlers that are caught and returned as JSON.
The npm package nextjs-exception-middleware receives a total of 4,420 weekly downloads. As such, nextjs-exception-middleware popularity was classified as popular.
We found that nextjs-exception-middleware demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.