axios-exception-handler

🔃 Axios Exception Handler

A lightweight utility for clean and customizable Axios error handling.

Installation

``bash
npm install axios-exception-handler
`

`bash
yarn add axios-exception-handler
`

Usage

Easily handle Axios errors with custom messages for specific HTTP status codes.

$3

`typescript
import axios from "axios";
import { ExceptionHandler } from "axios-exception-handler";

const getHello = async ({ name }) => {
try{
const response = await axios.post("/hello", {
name,
studentId,
phoneNumber,
});
} catch(err) {
ExceptionHandler(err)
.addCase(404, "Cannot Find User")
.addCase(409, "Conflict")
.addCases([500, 501, 503], "Server Error")
.addDefaultCase("Unexpected Error")
.handle();
}

return new ExceptionHandler(response)

};

// Usage
getHello()
.then((data) => {
console.log(data); // Hello name
})
.catch((err) => {
console.error(err); // 'Cannot Find User' | 'Conflict' | 'Server Error'
toast.error(err); // Render Toast From Derived Error
});
`

Features

- Custom Error Messages: Map HTTP status codes to specific error messages.
- Simple API: Easily chain addCase or addCases methods.
- TypeScript Support: Fully typed for seamless integration.

API

$3

#### Methods:

addCase(code: number, message: string): this
Add a single HTTP status code to handle with a custom message.

addCases(codes: number[], message: string): this
Add multiple HTTP status codes to handle with the same custom message.

handle(): AxiosResponse | Error`
Throws an error with the custom message if the status code matches, otherwise returns the Axios response.

License

This project is licensed under the ISC License.