Formations — 1 037 leçons en français

Accueil › Angular › Portée d'un service : root, composant, route

Portée d'un service : root, composant, route

Gestion d'étatintermediaire

Un service Angular n'est pas forcément un singleton global : sa portée dépend d'où il est fourni (providers), et détermine combien d'instances existent et combien de temps chacune vit.

// Root : singleton applicatif
@Injectable({ providedIn: 'root' })
export class UtilisateurStore { /* ... */ }

// Composant : une instance par instance du composant
@Component({
  selector: 'app-fiche-produit',
  providers: [AssistantAchatService],
})
export class FicheProduit { /* ... */ }

// Route : une instance partagée par la fonctionnalité
export const routes: Routes = [
  {
    path: 'catalogue',
    providers: [CatalogueFiltresStore],
    children: [
      { path: 'liste', loadComponent: () => import('./catalogue-liste').then(m => m.CatalogueListe) },
      { path: 'carte', loadComponent: () => import('./catalogue-carte').then(m => m.CatalogueCarte) },
    ],
  },
];

Angular résout un service en remontant la hiérarchie des injecteurs : composant demandeur, composants ancêtres, injecteur de la route active, puis injecteur racine. Le premier niveau qui fournit le service l'emporte.

Les termes à connaître

providedIn: 'root'

Enregistre le service auprès de l'injecteur racine de l'application : une seule instance, partagée par tout le monde, créée à la première injection (tree-shakable : absente du bundle si jamais injectée).

providers (composant)

Un tableau providers déclaré dans @Component({ providers: [...] }) crée une nouvelle instance du service pour ce composant et ses descendants. Chaque instance du composant obtient sa propre instance du service.

providers (route)

Un tableau providers déclaré sur une entrée de Routes crée un injecteur propre à cette route (et ses routes filles) : l'état est partagé par toute la fonctionnalité, et détruit quand on quitte la route.

Hiérarchie des injecteurs

Angular cherche un service en remontant d'injecteur en injecteur (composant → composants ancêtres → route → racine). Le premier injecteur qui a un provider pour ce service fournit l'instance : c'est la portée la plus proche qui gagne.

providedIn: 'platform' / 'any'

'platform' : instance partagée entre plusieurs applications Angular sur la même page (cas rare). 'any' : une instance distincte par point d'entrée chargé paresseusement (loadChildren/loadComponent), utile pour un état qui ne doit pas fuiter d'une fonctionnalité à l'autre.

Durée de vie de l'état

L'état d'un service vit aussi longtemps que l'injecteur qui l'a créé. Un service root vit pour toute la session applicative ; un service fourni par un composant ou une route est détruit avec lui.

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.