A NestJS rendelkezik egy beépített kivételkezelési réteggel, amely automatikusan elfogja a kezeletlen hibákat, és megfelelő HTTP válaszokká alakítja azokat. A hibákat kivételek dobásával jelezzük (gyakran beépített HTTP kivétel osztályokat használva), és a Nest strukturált JSON válaszokká formázza azokat a megfelelő állapotkóddal.
{ , , } ;
()
() {
user = ..(id);
(!user) {
();
}
user;
}
A NestJS kivétel osztályokat biztosít, amelyek HTTP állapotkódokra vannak leképezve, és az egyik dobása automatikusan helyes, strukturált választ produkál:
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
BadRequestException → 400
UnauthorizedException → 401
ForbiddenException → 403
NotFoundException → 404
ConflictException → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
Van egy osztály minden gyakori HTTP hibához — használd a megfelelőt a helyes státusz közléséhez.
// 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
Az egyenletes hibakezeléshez, naplózáshoz vagy nem HTTP hibák kezeléséhez kivételszűrőket használsz (egy kapcsolódó, fejlettebb funkció).
A megfelelő kivételkezelés elengedhetetlen a megbízható API-k építéséhez, és a NestJS beépített kivételkezelési rétege ezt tiszta és konzisztens módon teszi lehetővé.
Annak megértése, hogy hogyan lehet HTTP kivételeket dobni (NotFoundException, BadRequestException stb.), napi ismeretanyag — ez az idiomatikus módja a hibák jelzésének a helyes állapotkódokkal és strukturált, klienbarát JSON válaszokkal, anélkül hogy minden kezelőben manuálisan összeállítanánk a hibaválaszokat.
A keretrendszer automatikusan elfogja ezeket és formázza, és biztonságosan konvertálja az váratlan hibákat általános 500-as hibákká, anélkül hogy belső részleteket szivárogtatna (fontos a biztonság szempontjából).
A gyakori kivétel osztályok ismerete, az egyéni üzenetek/kivételek dobása, és az, hogy az kivételszűrők léteznek a globális testreszabáshoz (konzisztens formázás, naplózás), alapvető a robusztus, professzionális NestJS API-k építéséhez.
A tiszta, konzisztens hibakezelés a magas minőségű háttérrendszer kód jellemzője, ezért ez a keretrendszer egyik alapvető, gyakran használt aspektusa.