NestJS dispose d'une couche d'exception intégrée qui capture automatiquement les erreurs non gérées et les transforme en réponses HTTP appropriées. Vous signalez les erreurs en levant des exceptions (souvent des classes d'exception HTTP intégrées), et Nest les formate en réponses JSON structurées avec le bon code de statut.
{ , , } ;
()
() {
user = ..(id);
(!user) {
();
}
user;
}
NestJS fournit des classes d'exception mappées aux codes de statut HTTP, et en lever une produit automatiquement une réponse correcte et structurée :
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
BadRequestException → 400
UnauthorizedException → 401
ForbiddenException → 403
NotFoundException → 404
ConflictException → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
Il existe une classe pour chaque erreur HTTP courante — utilisez la classe appropriée pour communiquer le bon statut.
// 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
Pour un formatage d'erreur cohérent, la journalisation ou la gestion d'erreurs non-HTTP, vous utilisez les filtres d'exception (une fonctionnalité connexe, plus avancée).
La gestion appropriée des exceptions est essentielle pour construire des APIs fiables, et la couche d'exception intégrée de NestJS la rend propre et cohérente.
Comprendre comment lever des exceptions HTTP (NotFoundException, BadRequestException, etc.) est une connaissance quotidienne — c'est la façon idiomatique de signaler les erreurs avec les bons codes de statut et des réponses JSON structurées et conviviales pour le client, sans construire manuellement des réponses d'erreur dans chaque handler.
Le framework capture automatiquement ces exceptions et les formate, et il convertit en toute sécurité les erreurs inattendues en 500s génériques sans divulguer les détails internes (important pour la sécurité).
Connaître les classes d'exception courantes, comment lever des exceptions/messages personnalisés, et que les filtres d'exception existent pour la personnalisation globale (formatage cohérent, journalisation) est fondamental pour construire des APIs NestJS robustes et professionnelles.
La gestion des erreurs propre et cohérente est une marque de qualité du code back-end, ce qui en fait un aspect fondamental et fréquemment utilisé du framework.