Kas yra HTTP perėmėjai (interceptors)?

Question

Accepted Answer

**HTTP perėmėjai** sėdi kiekvieno `HttpClient` užklausos/atsakymo viduryje, leidžiantys jums juos globaliai tikrinti ir transformuoti. Jie yra puiki vieta **skersai pjaustiems susirūpinimams** (cross-cutting concerns), kurie taikomi visoms užklausoms — autentifikacijos žetonai, registravimas (logging), klaidų valdymas, įkėlimo indikatoriai.

## Funkcinis perėmėjas (šiuolaikinis Angular)

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

Perėmėjas gauna užklausą ir `next` funkciją (sekantis manipuliatorius). Labai svarbu, kad užklausos yra **neišmainomi** (immutable), todėl jūs naudojate `.clone()` su pakeitimais, o ne tiesiogiai modifikuojate. Jei užregistruojate tai kartą, kiekviena siunčiama užklausa automatiškai turi autentifikacijos antraštę — nereikia jos kartoti kiekvienoje paslaugoje.

## Perėmėjų registravimas

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

Kelis perėmėjai sudaro **grandinę**, kiekvienas praeina sekantiam — eilutės tvarka svarbi.

## Atsakymų ir klaidų globalinis valdymas

```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);
    })
  );
```

Kadangi perėmėjai apgaubia ir atsakymo Observable, jūs galite valdyti klaidas (pvz., nukreipti per 401, parodyti iškylantį pranešimą) **vienoje vietoje** visai programai.

## Dažni perėmėjų naudojimo atvejai

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

## Kodėl tai svarbu

Perėmėjai centralizuoja logiką, kuri priešingu atveju būtų dubliuojama visose HTTP užklausose — svarbiausia pritvirtinti autentifikacijos žetonus ir globaliai valdyti klaidas.

Tai laiko paslaugas švarias (jos tiesiog daro užklausas) ir užtikrina nuoseklų elgesį visoje programoje.

Autentifikacijos žetono ir globalinio klaidų perėmėjai yra beveik universalūs produkcijos Angular programose; žinojimas apie clone-to-modify taisyklę ir grandinės modelį yra esminis norint juos parašyti teisingai.