Angular Academy · Lekcja

Funkcyjne strażniki tras

Chronić trasy za pomocą funkcyjnych strażników

Funkcyjne strażniki tras to bezpłatna lekcja Angular Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Angular Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Angular Academy zawiera 4 lekcji w sumie.

Czym są strażniki ścieżek

Strażniki decydują, czy nawigacja może być kontynuowana: chronią ścieżki wymagające uwierzytelnienia, proszą o potwierdzenie przed opuszczeniem formularza lub ograniczają dostęp według roli. Współczesny Angular korzysta z funkcyjnych strażników — zwykłych funkcji, a nie klas.

CanActivateFn

Funkcja CanActivateFn zwraca true, aby zezwolić na nawigację, false, aby ją zablokować, UrlTree, aby przekierować, albo obserwowalny lub promise zawierający jedną z tych wartości.

import { CanActivateFn } from '@angular/router';
import { inject } from '@angular/core';

export const authGuard: CanActivateFn = () => {
  const auth = inject(AuthService);
  return auth.isLoggedIn();
};

Podłączanie guarda do trasy

Guardy należy dołączać za pomocą canActivate (jest to tablica, więc można łączyć kilka guardów).

export const routes = [
  { path: 'dashboard', component: DashboardComponent,
    canActivate: [authGuard] }
];

Przekierowywanie za pomocą UrlTree

Zwrócenie obiektu UrlTree (z funkcji router.createUrlTree lub parseUrl) jednocześnie blokuje i przekierowuje nawigację.

export const authGuard: CanActivateFn = () => {
  const auth = inject(AuthService);
  const router = inject(Router);
  return auth.isLoggedIn() ? true : router.parseUrl('/login');
};

Guardy asynchroniczne

Guardy mogą zwracać observable — router czeka na pierwszą wartość, a następnie go kończy.

export const authGuard: CanActivateFn = () => {
  const auth = inject(AuthService);
  return auth.checkSession$().pipe(
    map(ok => ok ? true : inject(Router).parseUrl('/login'))
  );
};

Dostęp do informacji o trasie w guardzie

Funkcja CanActivateFn otrzymuje ActivatedRouteSnapshot i RouterStateSnapshot, dzięki czemu można odczytać parametry, dane oraz adres URL, pod który podjęto próbę nawigacji.

export const roleGuard: CanActivateFn = (route, state) => {
  const needed = route.data['role'];
  const auth = inject(AuthService);
  return auth.hasRole(needed);
};

Guardy canMatch

CanMatchFn decyduje, czy definicja trasy w ogóle pasuje — jest to przydatne do przełączania tras za pomocą flagi funkcji lub ładowania leniwego tylko wtedy, gdy jest dozwolone.

import { CanMatchFn } from '@angular/router';

export const featureGuard: CanMatchFn = () =>
  inject(FeatureService).enabled('beta');

Guardy canDeactivate

CanDeactivateFn uruchamia się przy opuszczaniu trasy — doskonale nadaje się do potwierdzania wyjścia przy niezapisanych zmianach. Otrzymuje instancję komponentu.

import { CanDeactivateFn } from '@angular/router';

export const unsavedGuard: CanDeactivateFn<FormComponent> =
  (component) => component.isPristine() || confirm('Discard changes?');

Łączenie wielu guardów

Wszystkie guardy w tablicy muszą zezwolić na nawigację. Uruchamiają się razem; jeśli którykolwiek zwróci false lub UrlTree, nawigacja zostanie zablokowana albo nastąpi przekierowanie.

canActivate: [authGuard, roleGuard]
// both must pass

Dlaczego guardy funkcyjne zamiast klasowych

Guardy funkcyjne są prostsze: nie wymagają dodatkowego kodu @Injectable, ułatwiają korzystanie z inject(), można je komponować, a także podlegają tree-shakingowi. Interfejsy klasowe CanActivate są przestarzałe.

Guardy a trasy podrzędne

canActivateChild chroni wszystkie trasy podrzędne rodzica w jednym miejscu, dzięki czemu nie trzeba powtarzać guarda przy każdej trasie podrzędnej.

{ path: 'admin', canActivateChild: [authGuard],
  children: [ /* all protected */ ] }

Szybkie sprawdzenie

Sprawdź swoją wiedzę na temat guardów funkcyjnych.

Podsumowanie: funkcyjne guardy tras

Guardy funkcyjne sterują nawigacją za pomocą zwykłych funkcji.

CanActivateFn: zezwala, blokuje lub przekierowuje (UrlTree).
CanMatchFn: decyduje, czy trasa w ogóle pasuje.
CanDeactivateFn: potwierdza opuszczenie trasy.
Do usług należy używać inject(), a guardy łączyć w tablicach.

Następnie: zdarzenia routera i nawigacja.

Często zadawane pytania

Czy lekcja „Funkcyjne strażniki tras” jest bezpłatna?

Tak — pełny tekst „Funkcyjne strażniki tras” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Angular Academy, przejdź na CoddyKit PRO. Kurs Angular Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Funkcyjne strażniki tras”?

Chronić trasy za pomocą funkcyjnych strażników Ćwiczysz Angular Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Angular Academy?

Nie wymagamy żadnego doświadczenia. Angular Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Funkcyjne strażniki tras”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Angular Academy?

Tak. Każda lekcja Angular Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Angular Academy