Çfarë janë përgjuesit HTTP?

Question

Accepted Answer

**Përgjuesit HTTP** ndodhen në mes të çdo kërkese/përgjigje `HttpClient`, duke ju lejuar të inspektoni dhe transformoni ato globalisht. Ato janë vendi i përsosur për **shqetësimet ndërkesore** që zbatohen në të gjitha kërkesät — tokenat e autentifikimit, regjistrimi, trajtimi i gabimeve, treguesit e ngarkimit.

## Përgjues funksional (Angular modern)

```ts
import { HttpInterceptorFn } from "@angular/common/http";
import { inject } from "@angular/core";

export const authInterceptor: HttpInterceptorFn = (req, next) => {
  const token = inject(AuthService).getToken();

// requests are immutable — CLONE to modify
  const authReq = req.clone({
    setHeaders: { Authorization: `Bearer ${token}` }, // attach token to EVERY request
  });

return next(authReq); // pass the (modified) request along the chain
};
```

Përgjuesi merr kërkesën dhe funksionin `next` (përpunuesi tjetër). Në mënyrë kritike, kërkesät janë **të pandryshueshme**, kështu që ju `.clone()` me ndryshime në vend që të mutajoni. Regjistrimi i kësaj një herë do të thotë se çdo kërkesë dalëse automatikisht mban kokën e autentifikimit — pa e përsëritur në çdo shërbim.

## Regjistrimi i përgjuesve

```ts
bootstrapApplication(AppComponent, {
  providers: [
    provideHttpClient(withInterceptors([authInterceptor, errorInterceptor, loggingInterceptor])),
  ],
});
```

Përgjuesit e shumtë formojnë një **zinxhir**, ku secila kalon në tjetrën — rendi ka rëndësi.

## Trajtimi i përgjigjeve dhe gabimeve globalisht

```ts
import { catchError } from "rxjs/operators";
import { throwError } from "rxjs";

export const errorInterceptor: HttpInterceptorFn = (req, next) =>
  next(req).pipe(
    catchError((err) => {
      if (err.status === 401) inject(Router).navigate(["/login"]); // global 401 handling
      inject(NotificationService).showError(err.message);
      return throwError(() => err);
    })
  );
```

Sepse përgjuesit përmbulojnë gjithashtu Observable-in e përgjigjes, ju mund të trajtoni gabimet (p.sh. ridrejtim në 401, shfaqje të një tostit) në **një vend** për të gjithë aplikacionin.

## Përdorimet e zakonshme të përgjuesit

```text
✓ Attach auth tokens to requests
✓ Global error handling (401 → login, show notifications)
✓ Logging / analytics of all HTTP traffic
✓ Show/hide a global loading spinner
✓ Add common headers, retry logic, caching
```

## Pse është e rëndësishme

Përgjuesit centralizojnë logjikën që ndryshe do të ishte dyfishuar në të gjitha thirrjet HTTP — më e rëndësishmja është bashkangitja e tokenave të autentifikimit dhe trajtimi i gabimeve globalisht.

Kjo mban shërbimegrupet të pastërt (ata vetëm bëjnë kërkesät) dhe siguron sjellje të qëndrueshme në të gjithë aplikacionin.

Përgjuesit e tokenave të autentifikimit dhe të gabimit global janë pothuajse univerzal në aplikacionet Angular të prodhimit; njohja e rregullit clone-to-modify dhe modelit të zinxhirit është thelbësore për t'i shkruar ato në mënyrë të saktë.