A comprehensive collection of error classes for robust error handling in TypeScript applications.
NowaraJS Error provides a structured approach to error handling with enhanced error classes that include additional metadata like unique identifiers, timestamps, and HTTP status codes. It's designed to improve debugging and error tracking in modern applications.
bun add @nowarajs/error
Note: This package supports both Bun and Node.js environments.
import { BaseError, HttpError } from '@nowarajs/error';
// Basic error with message
try {
throw new BaseError({ message: 'Something went wrong' });
} catch (error) {
if (error instanceof BaseError) {
console.log(`Error ID: ${error.uuid}`);
console.log(`Occurred at: ${error.date.toISOString()}`);
console.log(`Message: ${error.message}`);
}
}
// HTTP error with status code
try {
throw new HttpError({
message: 'User not found',
httpStatusCode: 'NOT_FOUND'
});
} catch (error) {
if (error instanceof HttpError) {
console.log(`HTTP Status: ${error.httpStatusCode}`); // 404
console.log(`Is client error: ${error.isClientError}`); // true
console.log(`Is server error: ${error.isServerError}`); // false
}
}
The foundation error class with enhanced metadata:
| Property | Type | Description |
|---|---|---|
uuid |
string |
Unique identifier for the error |
date |
Date |
Timestamp when the error was created |
message |
string |
Error message |
cause |
TCause |
Optional cause of the error |
Extends BaseError with HTTP-specific functionality:
| Property | Type | Description |
|---|---|---|
httpStatusCode |
number |
HTTP status code (400-511) |
isClientError |
boolean |
True if status code is 4xx |
isServerError |
boolean |
True if status code is 5xx |
// Client errors (4xx)
'BAD_REQUEST', 'UNAUTHORIZED', 'FORBIDDEN', 'NOT_FOUND',
'METHOD_NOT_ALLOWED', 'CONFLICT', 'UNPROCESSABLE_ENTITY',
'TOO_MANY_REQUESTS', // ... and more
// Server errors (5xx)
'INTERNAL_SERVER_ERROR', 'NOT_IMPLEMENTED', 'BAD_GATEWAY',
'SERVICE_UNAVAILABLE', 'GATEWAY_TIMEOUT' // ... and more
You can find the complete API reference documentation for NowaraJS Error at:
Distributed under the MIT License. See LICENSE for more information.