NestJS har et innebygd unntakslag som automatisk fanger uhåndterte feil og konverterer dem til passende HTTP-svar. Du signaliserer feil ved å kaste unntak (ofte innebygde HTTP-unntaksklasser), og Nest formaterer dem til strukturerte JSON-svar med riktig statuskode.
{ , , } ;
()
() {
user = ..(id);
(!user) {
();
}
user;
}
NestJS gir unntaksklasser som kartlegges til HTTP-statuskoder, og å kaste ett produserer automatisk et korrekt, strukturert svar:
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
BadRequestException → 400
UnauthorizedException → 401
ForbiddenException → 403
NotFoundException → 404
ConflictException → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
Det finnes en klasse for hver vanlig HTTP-feil — bruk den passende for å kommunisere riktig status.
// 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
For konsistent feilformatering, logging eller håndtering av ikke-HTTP-feil bruker du unntaksfiltre (en relatert, mer avansert funksjon).
Riktig unntakshåndtering er essensielt for å bygge pålitelige APIer, og NestJS sitt innebygde unntakslag gjør det rent og konsistent.
Å forstå hvordan du kaster HTTP-unntak (NotFoundException, BadRequestException, osv.) er hverdagskunnskaper — det er den idiomatiske måten å signalisere feil med riktige statuskoder og strukturerte, klientvennlige JSON-svar, uten å manuelt konstruere feilvarsler i hver handler.
Rammeverket fanger automatisk disse og formaterer dem, og det konverterer trygt uventede feil til generiske 500-er uten å lekke interne detaljer (viktig for sikkerhet).
Å kjenne til vanlige unntaksklasser, hvordan du kaster egendefinerte meldinger/unntak, og at unntaksfiltre finnes for global tilpasning (konsistent formatering, logging) er grunnleggende for å bygge robuste, profesjonelle NestJS-APIer.
Ren, konsistent feilhåndtering er et kjennetegn på kvalitetskode i back-end, noe som gjør dette til et kjerneaspekt av rammeverket som brukes hyppig.