Formations — 1 037 leçons en français

Accueil › Angular › Protéger et préparer une route

Protéger et préparer une route

Le routeurdebutant

Un guard décide si une navigation peut avoir lieu. En Angular 21, on écrit des guards fonctionnels — de simples fonctions, pas de classes :

import { inject } from '@angular/core';
import { CanActivateFn, Router } from '@angular/router';
import { AuthService } from './auth-service';

export const authGuard: CanActivateFn = (route, state) => {
  const auth = inject(AuthService);
  const router = inject(Router);

  return auth.estConnecte() || router.createUrlTree(['/connexion']);
};
{ path: 'compte', component: EspaceClient, canActivate: [authGuard] }

Un guard renvoie true (ou une valeur assimilable, Observable<boolean>/Promise<boolean>) pour autoriser, false pour bloquer, ou un UrlTree (via router.createUrlTree(...)) pour rediriger. CanMatchFn fonctionne différemment : un refus fait passer à la route suivante du tableau, plutôt que de bloquer la navigation — pratique pour choisir entre deux routes de même chemin.

Un resolver précharge une donnée avant que la route ne s'active :

export const produitResolver: ResolveFn<Produit> = (route) => {
  const produits = inject(ProduitService);
  return produits.chargerParId(route.paramMap.get('id')!);
};
{ path: 'produits/:id', component: FicheProduit, resolve: { produit: produitResolver } }

La navigation attend la fin du resolver : le composant s'affiche déjà avec sa donnée, sans état de chargement à gérer manuellement — mais l'utilisateur ne voit rien bouger pendant l'attente.

Les termes à connaître

CanActivateFn

Type d'un guard fonctionnel exécuté avant l'activation d'une route. Renvoie (ou résout en) true pour autoriser la navigation, false pour la bloquer, ou un UrlTree pour rediriger ailleurs.

CanMatchFn

Type d'un guard fonctionnel exécuté avant même que la route soit sélectionnée. S'il renvoie false, le routeur continue d'essayer les routes suivantes du tableau — utile pour faire correspondre deux routes différentes au même chemin selon une condition.

CanDeactivateFn

Type d'un guard fonctionnel exécuté avant de quitter une route déjà affichée. Reçoit le composant courant en premier paramètre ; sert typiquement à demander confirmation avant d'abandonner un formulaire non enregistré.

UrlTree

Représentation interne d'une URL, produite par Router.createUrlTree() ou Router.parseUrl(). Un guard qui renvoie un UrlTree déclenche une redirection vers cette URL, au lieu de simplement bloquer la navigation.

ResolveFn

Type d'un resolver fonctionnel qui précharge une donnée avant qu'une route ne s'active. La navigation attend que la valeur renvoyée (ou l'Observable/Promise) se termine avant d'afficher le composant.

inject() dans un guard ou un resolver

Les guards et resolvers fonctionnels sont de simples fonctions, exécutées dans le contexte d'injection du routeur : on y utilise inject(MonService) pour accéder aux services, exactement comme dans un constructeur de composant.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.