NestJS ka një shtresë përjashtime të ndërtuar që automatikisht kap gabimet e pa trajtuar dhe i shndërron ato në përgjigje të duhura HTTP. Ju sinjalizoni gabimet duke hedhur përjashtime (shpesh klasat e përjashtime HTTP të ndërtuar), dhe Nest i formaeson ato në përgjigje JSON të strukturuara me kodin e duhur të statusit.
{ , , } ;
()
() {
user = ..(id);
(!user) {
();
}
user;
}
NestJS siguron klasa përjashtimesh që hartojnë me kodet e statusit HTTP, dhe hedhja e njërit prodhon një përgjigje të saktë, të strukturuar automatikisht:
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
BadRequestException → 400
UnauthorizedException → 401
ForbiddenException → 403
NotFoundException → 404
ConflictException → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
Ka një klasë për secilin gabim HTTP të zakonshëm — përdorni atë të përshtatshme për të komunikuar statusin e duhur.
// custom status + body via the base HttpException
throw new HttpException(
{ status: HttpStatus.FORBIDDEN, error: "custom message" },
HttpStatus.FORBIDDEN,
);
export class UserNotFoundException extends NotFoundException {
constructor(id: string) {
super(`User with id ${id} not found`); // domain-specific, reusable
}
}
throw new UserNotFoundException(id);
If code throws a non-HttpException error (e.g. a plain Error or an unexpected
exception), NestJS's default exception filter catches it and returns a generic
500 Internal Server Error (without leaking internal details to the client).
// a custom exception filter customizes how errors are formatted/logged globally
@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
catch(exception: unknown, host: ArgumentsHost) {
// log, format the response, etc.
}
}
app.useGlobalFilters(new AllExceptionsFilter()); // apply app-wide
Për formatim konsistent të gabimeve, regjistrim ose trajtim të gabimeve jo-HTTP, përdorni filtrat e përjashtimeve (një tipar i lidhur, më i avancuar).
Trajtimi i duhur i përjashtimeve është thelbësor për ndërtimin e API-ve të besueshme, dhe shtresa e përjashtimeve të ndërtuar në NestJS e bën atë të pastër dhe konsistente.
Kuptimi i mënyrës se si të hedhësh përjashtime HTTP (NotFoundException, BadRequestException, etj.) është njohuri e përditshme — është mënyra idiomatike për të sinjalizuar gabimet me kodet e duhura të statusit dhe përgjigje JSON të strukturuara, miqësore ndaj klientit, pa ndërtuar manuale përgjigje të gabimit në secilin handler.
Frameworku automatikisht kap këto dhe i formaeson, dhe në mënyrë të sigurt shndërron gabimet e papritur në 500s gjenerike pa zbuluar detaje të brendshme (e rëndësishme për sigurinë).
Njohja e klasave të zakonshme të përjashtimeve, mënyra se si të hedhësh përjashtime dhe mesazhe të personalizuara, dhe se filtrat e përjashtimeve ekzistojnë për përshtatje globale (formatim konsistent, regjistrim) është themelore për ndërtimin e API-ve robust dhe profesionale NestJS.
Trajtimi i pastër dhe konsistent i gabimeve është një shenjë e kodit të back-end-it cilësor, duke e bërë këtë një aspekt themelor, të përdorur shpesh të frameworkut.