Jak zpracováváte výjimky v NestJS?

Question

Accepted Answer

NestJS má **vestavěnou vrstvu zpracování výjimek**, která automaticky zachytí neošetřené chyby a převede je na správné HTTP odpovědi. Signalizujete chyby **vyhodením výjimek** (často vestavěných tříd HTTP výjimek), a Nest je zformátuje do strukturovaných JSON odpovědí se správným stavovým kódem.

## Vyhodování vestavěných HTTP výjimek

```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 poskytuje třídy výjimek mapované na HTTP stavové kódy, a vyhodení jedné automaticky vytvoří správnou, strukturovanou odpověď:

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

## Běžné vestavěné HTTP výjimky

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

Existuje třída pro každou běžnou HTTP chybu — použijte tu správnou k tomu, abyste komunikovali správný stav.

## Vlastní zprávy a generická HttpException

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

## Vlastní třídy výjimek

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

## Neošetřené chyby se stanou 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).
```

## Filtry výjimek pro globální přizpůsobení

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

Pro konzistentní formátování chyb, logování nebo zpracování non-HTTP chyb používáte **filtry výjimek** (související, pokročilejší funkce).

## Proč na tom záleží

Správné zpracování výjimek je nezbytné pro budování spolehlivých API, a vestavěná vrstva výjimek NestJS to dělá čistě a konzistentně.

Porozumění tomu, jak **vyhodit HTTP výjimky** (`NotFoundException`, `BadRequestException` atd.), je každodenní znalostí — je to idiomatický způsob, jak signalizovat chyby se správnými stavovými kódy a strukturovanými, přátelskými JSON odpověďmi pro klienty, bez ručního konstruování chybových odpovědí v každém handleru.

Framework je automaticky zachytí a zformátuje, a bezpečně převede neočekávané chyby na generické 500 bez úniku interních podrobností (důležité pro bezpečnost).

Znalost běžných tříd výjimek, jak vyhodit vlastní zprávy/výjimky a že **filtry výjimek** existují pro globální přizpůsobení (konzistentní formátování, logování), je fundamentální pro budování robustních, profesionálních NestJS API.

Čisté, konzistentní zpracování chyb je poznámkou kvality back-endového kódu, což z toho činí klíčový, často používaný aspekt frameworku.