আপনি NestJS-এ ব্যতিক্রম (exceptions) কীভাবে পরিচালনা করেন?

Question

Accepted Answer

NestJS একটি **বিল্ট-ইন ব্যতিক্রম স্তর** রয়েছে যা স্বয়ংক্রিয়ভাবে অপ্রত্যাশিত ত্রুটিগুলি ক্যাপচার করে এবং সেগুলিকে সঠিক HTTP প্রতিক্রিয়ায় রূপান্তরিত করে। আপনি **ব্যতিক্রম নিক্ষেপ করে** ত্রুটিগুলি সংকেত দেন (প্রায়শই বিল্ট-ইন HTTP ব্যতিক্রম ক্লাস), এবং Nest সেগুলিকে সঠিক স্ট্যাটাস কোড সহ কাঠামোবদ্ধ JSON প্রতিক্রিয়ায় ফর্ম্যাট করে।

## বিল্ট-ইন HTTP ব্যতিক্রম নিক্ষেপ করা

```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 HTTP স্ট্যাটাস কোডের সাথে ম্যাপ করা ব্যতিক্রম ক্লাস প্রদান করে, এবং একটি নিক্ষেপ করলে স্বয়ংক্রিয়ভাবে সঠিক, কাঠামোবদ্ধ প্রতিক্রিয়া উৎপাদিত হয়:

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

## সাধারণ বিল্ট-ইন HTTP ব্যতিক্রম

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

প্রতিটি সাধারণ HTTP ত্রুটির জন্য একটি ক্লাস রয়েছে — সঠিক স্ট্যাটাস যোগাযোগ করতে উপযুক্তটি ব্যবহার করুন।

## কাস্টম বার্তা এবং জেনেরিক HttpException

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

## কাস্টম ব্যতিক্রম ক্লাস

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

## অপ্রত্যাশিত ত্রুটিগুলি 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).
```

## গ্লোবাল কাস্টমাইজেশনের জন্য ব্যতিক্রম ফিল্টার

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

সামঞ্জস্যপূর্ণ ত্রুটি ফর্ম্যাটিং, লগিং, বা non-HTTP ত্রুটি পরিচালনার জন্য, আপনি **ব্যতিক্রম ফিল্টার** ব্যবহার করেন (একটি সম্পর্কিত, আরও উন্নত বৈশিষ্ট্য)।

## এটি কেন গুরুত্বপূর্ণ

যথাযথ ব্যতিক্রম পরিচালনা নির্ভরযোগ্য API নির্মাণের জন্য অপরিহার্য, এবং NestJS এর বিল্ট-ইন ব্যতিক্রম স্তর এটিকে পরিষ্কার এবং সামঞ্জস্যপূর্ণ করে তোলে।

**HTTP ব্যতিক্রম নিক্ষেপ করা** জানা (`NotFoundException`, `BadRequestException`, ইত্যাদি) দৈনন্দিন জ্ঞান — এটি সঠিক স্ট্যাটাস কোড এবং কাঠামোবদ্ধ, ক্লায়েন্ট-বান্ধব JSON প্রতিক্রিয়ার সাথে ত্রুটি সংকেত করার আইডিওম্যাটিক উপায়, প্রতিটি হ্যান্ডলারে ম্যানুয়ালি ত্রুটি প্রতিক্রিয়া তৈরি করা ছাড়াই।

ফ্রেমওয়ার্ক স্বয়ংক্রিয়ভাবে এগুলি ক্যাপচার করে এবং ফর্ম্যাট করে, এবং এটি নিরাপদভাবে অপ্রত্যাশিত ত্রুটিগুলিকে জেনেরিক 500-এ রূপান্তরিত করে অভ্যন্তরীণ বিবরণ লিক না করে (নিরাপত্তার জন্য গুরুত্বপূর্ণ)।

সাধারণ ব্যতিক্রম ক্লাস জেনে, কীভাবে কাস্টম বার্তা/ব্যতিক্রম নিক্ষেপ করতে হয়, এবং যে **ব্যতিক্রম ফিল্টার** গ্লোবাল কাস্টমাইজেশনের জন্য বিদ্যমান তা জেনে (সামঞ্জস্যপূর্ণ ফর্ম্যাটিং, লগিং) দৃঢ়, পেশাদার NestJS API নির্মাণের জন্য মৌলিক।

পরিষ্কার, সামঞ্জস্যপূর্ণ ত্রুটি পরিচালনা উচ্চ-মানের ব্যাক-এন্ড কোডের একটি বৈশিষ্ট্য, যা এটিকে ফ্রেমওয়ার্কের একটি মূল, ঘন ঘন ব্যবহৃত দিক করে তোলে।