Kaip tvarkote išimtis NestJS?

Question

Accepted Answer

NestJS turi **integruotą išimčių sluoksnį**, kuris automatiškai gaudys neapdorotus klaidas ir jas paverčia tinkamais HTTP atsakymais. Jūs apie klaidas signalizuojate **metant išimtis** (dažnai integruotas HTTP išimčių klases), o Nest jas formatuoja į struktūruotus JSON atsakymus su tinkamu būsenos kodu.

## Metant integruotus HTTP išimtis

```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 pateikia išimčių klases, susietas su HTTP būsenos kodais, ir metus vieną, gaunamas teisingas, struktūruotas atsakymas automatiškai:

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

## Dažnos integruotos HTTP išimtys

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

Yra kiekvienos dažnos HTTP klaidos klase — naudokite tinkamą, kad ataskaitytumėte tinkamą būseną.

## Pasirinktiniai pranešimai ir bendroji HttpException

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

## Pasirinktinės išimčių klasės

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

## Neapdorotos klaidos tampa 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).
```

## Išimčių filtrai globaliam tinkavimui

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

Dėl nuolatinio klaidų formatavimo, registravimo arba ne-HTTP klaidų tvarkymo, naudojate **išimčių filtrus** (susijusią, pažangesne funkcija).

## Kodėl tai svarbu

Tinkama išimčių tvarkyba yra labai svarbi norint sukurti patikimas API, o NestJS integruotas išimčių sluoksnis tai daro švariau ir nuosekliau.

Supratimas, kaip **metami HTTP išimtys** (`NotFoundException`, `BadRequestException` ir kt.), yra kasdienės žinios — tai idiomatinis būdas signalizuoti klaidas su tinkamais būsenos kodais ir struktūruotais, klijentams draugiškais JSON atsakymais, neruošiant klaidų atsakymų kiekviename tvarkytuve.

Sistema automatiškai gaudys šias ir jas formatuos, ir saugiai konvertuos nenumatytus klaidų į bendrinius 500 negrysdama vidinių detalių (svarbu saugumui).

Žinojimas apie bendras išimčių klases, kaip metami pasirinktiniai pranešimai/išimtys, ir kad **išimčių filtrai** egzistuoja globaliam tinkavimui (nuolatinis formatavimas, registravimas) yra pagrindinė žinias, reikalinga grįsti tvirtas, profesionalias NestJS API.

Švari, nuolatinė klaidų tvarkyba yra kokybės užpakalio kodo žyma, todėl tai yra pagrindinė, dažnai naudojama sistemos pusė.