elysia-http-error v1.3.0
Elysia HTTP Error
Throw HTTP errors from Elysia handlers.
Usage
Install the package:
bun add elysia-http-error
Then use httpError()
in Elysia pipeline as follow:
const app = new Elysia().use(httpError());
By default, this module will return a structured message with the error details.
If you need the message to be a simple string, use:
returnStringOnly: true;
when initializing httpError()
.
Another option is to write a custom error message formatter using:
customFormatter: (err: HttpError) => any;
which allows a full control over the returned error object.
For example:
customFormatter: (err) => `Oh no... we got an error ${err.statusCode}!`;
In order to use the HttpError class and throw an error, the HttpError
decorator must be added to the pipeline:
const app = new Elysia().use(httpErrorDecorator).get("/", ({ HttpError }) => {
throw HttpError.BadRequest("Something went wrong...");
});
The HttpError constructor receive the following parameters:
error: string (error message, optional)
errorData: any (more error details, optional)
For example, when using OTP validation and the user is asking for a new OTP while the OTP is still valid, the error can contain the message and the time left for the OTP so the client can display a proper message and sync the time displayed to the user:
throw HttpError.Conflict("OTP is still valid", {
timeLeft: otpExpireTime - Date.now(),
});
Some important notes
The plugin initializer must be called when initializing Elysia and before any other handler that use this plugin.
When using dependecy injection and sub-modules, the decorator must be used in the sub-module definition in order to get full type support (see https://elysiajs.com/patterns/dependency-injection.html#dependency-injection)