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.
providedIn: 'root'(dans@Injectable) : une seule instance pour toute l'application, tree-shakable. Le bon choix pour un état vraiment global (utilisateur connecté, panier).providerssur un composant : une nouvelle instance par instance du composant. Utile pour un état local à un composant complexe, partagé par ses enfants mais pas par le reste de l'app (un assistant d'achat par fiche produit, un état de formulaire multi-étapes).providerssur une route : une instance partagée par une route et ses routes filles, détruite en quittant cette branche. Le bon niveau pour un état propre à une fonctionnalité (filtres du catalogue, état d'un tunnel de commande).
// 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
providersdé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
providersdéclaré sur une entrée deRoutescré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
rootvit pour toute la session applicative ; un service fourni par un composant ou une route est détruit avec lui.
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.