Accueil › Angular › Providers avancés
Providers avancés
Injection de dépendances avancéeintermediaire
Au-delà du raccourci providers: [MonService] (qui utilise implicitement useClass), Angular offre plusieurs façons de configurer ce qu'un jeton renvoie :
providers: [
{ provide: JournalService, useClass: JournalServiceProd }, // une autre classe
{ provide: APP_CONFIG, useValue: { urlApi: '...' } }, // une valeur toute faite
{ provide: JournalAncien, useExisting: JournalService }, // un alias, même instance
{ provide: RemiseService, useFactory: creerRemise, deps: [APP_CONFIG] }, // construction déléguée
]
useClass instancie une classe (souvent différente du jeton lui-même). useValue fournit une valeur déjà construite, sans instanciation. useExisting crée un alias vers un provider existant — même instance, pas de duplication. useFactory délègue la construction à une fonction, dont les paramètres viennent du tableau deps (car useFactory ne s'exécute pas forcément dans un contexte d'injection permettant inject()).
L'option multi: true permet à plusieurs providers de contribuer au même jeton, qui devient alors un tableau — c'est ainsi qu'Angular assemble en interne les intercepteurs de classe (HTTP_INTERCEPTORS).
Pour configurer une fonctionnalité entière, Angular privilégie désormais les fonctions provideXxx() (provideHttpClient(), provideRouter()…), qui encapsulent la liste de providers nécessaire et se composent avec des options withXxx(). Le jeton APP_INITIALIZER suit la même évolution : déprécié depuis Angular 19 au profit de provideAppInitializer(). Enfin, forwardRef() résout les cas de dépendance circulaire entre deux éléments qui se référencent mutuellement.
Les termes à connaître
- useClass
Configuration de provider qui indique quelle classe instancier pour un jeton donné. Permet de fournir une implémentation différente de la classe utilisée comme jeton (ex. une version simulée en test, une implémentation enrichie en production).
- useValue
Configuration de provider qui fournit directement une valeur déjà construite, sans instanciation ni appel de fonction. Adaptée aux constantes, objets de configuration ou valeurs calculées une seule fois avant le bootstrap.
- useExisting
Configuration de provider qui crée un alias : le jeton renvoie la même instance qu'un autre provider déjà enregistré, plutôt que d'en créer une nouvelle. À ne pas confondre avec
useClass, qui instancie une classe séparée.- useFactory + deps
Configuration de provider qui délègue la construction de la valeur à une fonction. Le tableau
depsliste les jetons à injecter comme arguments de cette fonction, dans l'ordre — utile quandinject()n'est pas disponible (fonction externe non exécutée en contexte d'injection).- multi: true
Option de provider qui fait que plusieurs déclarations pour le même jeton s'accumulent dans un tableau au lieu de s'écraser. Utilisée par Angular lui-même pour les intercepteurs HTTP de classe (
HTTP_INTERCEPTORS) et les fonctions d'initialisation.- provideXxx()
Fonction qui encapsule un ensemble de providers liés à une fonctionnalité (
provideHttpClient(),provideRouter()…) et renvoie desEnvironmentProviders. Forme recommandée pour configurer une fonctionnalité ou une librairie : plus lisible qu'un tableauprovidersbrut, et composable avec des fonctionswithXxx().- provideAppInitializer()
Fonction qui enregistre du code exécuté au démarrage de l'application, avant le premier rendu — attend la résolution d'une
Promiseou d'unObservableretourné. Remplace le jetonAPP_INITIALIZER, déprécié depuis Angular 19.- forwardRef()
Fonction qui reporte la résolution d'une référence de classe, pour les cas où deux éléments dépendent l'un de l'autre et qu'aucun des deux n'est encore défini au moment où l'autre en a besoin (dépendance circulaire).
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.