Kif tiddaħħal l-eċċezzjonijiet f'NestJS?

Question

Accepted Answer

NestJS għandha **saff ta' eċċezzjoni integrat** li awtomatikament jaqbad l-iżbalji mhux iddaħħla u jibdelhom għal risponstas HTTP xierqa. Inti tissenja l-iżbalji billi **tarmux eċċezzjonijiet** (spiss klassez ta' eċċezzjoni HTTP integrati), u Nest ifformathom f'risponstas JSON strutturati b'kodiċi ta' status korrett.

## Qatt l-eċċezzjonijiet HTTP integrati

```ts
import { NotFoundException, BadRequestException, UnauthorizedException } from "@nestjs/common";

@Get(":id")
findOne(@Param("id") id: string) {
  const user = this.usersService.findOne(id);
  if (!user) {
    throw new NotFoundException("User not found");   // → 404 with a JSON error body
  }
  return user;
}
```

NestJS tipprovdi klassez ta' eċċezzjoni mappati għal kodiċi ta' status HTTP, u qatt waħda tipproduċi risponstas korrett u strutturata awtomatikament:

```json
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
```

## Eċċezzjonijiet HTTP integrati komuni

```text
BadRequestException        → 400
UnauthorizedException      → 401
ForbiddenException         → 403
NotFoundException          → 404
ConflictException          → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
```

Hemm klassi għal kull żball HTTP komuni — uża l-waħda xierqa biex tikkomunika l-istatus korrett.

## Messaġġi customizzati u l-HttpException ġeneriku

```ts
// custom status + body via the base HttpException
throw new HttpException(
  { status: HttpStatus.FORBIDDEN, error: "custom message" },
  HttpStatus.FORBIDDEN,
);
```

## Klassez ta' eċċezzjoni customizzata

```ts
export class UserNotFoundException extends NotFoundException {
  constructor(id: string) {
    super(`User with id ${id} not found`);   // domain-specific, reusable
  }
}
throw new UserNotFoundException(id);
```

## L-iżbalji mhux iddaħħla jsiru 500

```text
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).
```

## Filtri ta' eċċezzjoni għal customizzazzjoni globali

```ts
// 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
```

Għall-ifformattjar ta' żball kostanti, reġistrazzjoni, jew iddaħħla ta' żbalji mhux-HTTP, inti tuża **filtri ta' eċċezzjoni** (feature relatat u aktar avvanzat).

## Għaliex hija importanti

L-iddaħħla xierqa ta' eċċezzjonijiet hija essenzjali għall-bina ta' APIs affidabbli, u s-saff ta' eċċezzjoni integrat ta' NestJS jagħmilha nadifa u kostanti.

L-fehim ta' kif **tarmux eċċezzjonijiet HTTP** (`NotFoundException`, `BadRequestException`, eċċ.) hija għarifa ta' kuljum — din hija l-mod idiomatiku biex tissenja żbalji bl-kodiċi ta' status korrett u risponstas JSON strutturati u friendly għall-kliyent, mingħajr ma tibni manualment risponstas ta' żball f'kull manipulatur.

Il-framework awtomatikament jaqbad dawn u jifformathom, u b'mod sigur jibdel l-iżbalji mhux mistenni għal 500 ġeneriċi mingħajr ma tikkwota dettalji interni (importanti għas-sigurtà).

L-għarifa ta' klassez ta' eċċezzjoni komuni, kif tarmux messaġġi/eċċezzjonijiet customizzati, u li **filtri ta' eċċezzjoni** jeżistu għall-customizzazzjoni globali (ifformattjar kostanti, reġistrazzjoni) hija fundamentali għall-bina ta' APIs NestJS robusti u professjonali.

L-iddaħħla ta' żball nadifa u kostanti hija allegorija ta' kodiċi back-end ta' kwalità għolja, li jagħmilha aspett essenzjali u spiss użat tal-framework.