Tá sraith eisceachta ionsuite ag NestJS a ghlacann go huathoibríoch earráidí gan bhainistiú agus a athraíonn iad ina fhreagraí HTTP cuí. Tugann tú in iúl earráidí trí eisceachtaí a chaitheamh amach (go minic ranganna eisceachta HTTP ionsuite), agus formáideann Nest iad ina fhreagraí JSON struchtúrtha le an cód stádais ceart.
{ , , } ;
()
() {
user = ..(id);
(!user) {
();
}
user;
}
Tugann NestJS ranganna eisceachta ar fáil a léiriú ar chódanna stádais HTTP, agus cuiríonn tú fregra ceart, struchtúrtha ar fáil go huathoibríoch:
{ "statusCode": 404, "message": "User not found", "error": "Not Found" }
BadRequestException → 400
UnauthorizedException → 401
ForbiddenException → 403
NotFoundException → 404
ConflictException → 409
UnprocessableEntityException → 422
InternalServerErrorException → 500
Tá rang ann do gach earráid HTTP choitianta — úsáid an ceann cuí chun an stádas ceart a chur in iúl.
// 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
Chun formáidiú earráide comhsheasmhach, logáil, nó earráidí neamh-HTTP a bhainistiú, úsáideann tú scagairí eisceachta (gné níos fhorbartha agus ghaolmhar).
Tá bainistiú eisceachta cuí riachtanach chun APIanna iontaofa a thógáil, agus tugann sraith eisceachta ionsuite NestJS deis é a dhéanamh go geal agus go comhsheasmhach.
Tá tuiscint ar conas eisceachtaí HTTP a chaitheamh amach (NotFoundException, BadRequestException, srl.) -- is eolas gach lá é seo -- an dóigh idioimeapúil chun earráidí a dhéanamh ar fáil leis na códanna stádais cheart agus freagraí JSON struchtúrtha, barrúil don chliaint, gan freagraí earráide a thógáil go láimhdhírithe i ngach láimhseoir.
Glacann an fhramwork go huathoibríoch leo sin agus formáideann siad, agus athraíonn sí earráidí gan súil ann go 500s geal gan sonraí inmheánacha a nochtadh (tábhachtach do shlándáil).
An tuiscint ar na ranganna eisceachta coitianta, conas teachtaireachtaí/eisceachtaí saincheaptha a chaitheamh amach, agus go bhfuil scagairí eisceachta ann do bhainistiú dhomhanda (formáidiú comhsheasmhach, logáil) -- tá sé sin bunúsach chun APIanna NestJS láidir, proifisiúnta a thógáil.
Is tréith de bhailchualacht cód back-end de chalais é bainistiú earráide geal agus comhsheasmhach, ag déanamh an ghné seo a bheith ina príomhchuid, fhréamhúil-úsáidte den fhramwork.