Accueil › Angular › La fonction inject()
La fonction inject()
Injection de dépendances avancéeintermediaire
inject() récupère une dépendance depuis l'injecteur actif. C'est un strict équivalent de l'injection par constructeur, mais sous forme de fonction plutôt que de paramètre :
@Injectable({ providedIn: 'root' })
export class ProduitService {
// équivalent moderne
private http = inject(HttpClient);
private journal = inject(JournalService);
// équivalent classique
// constructor(private http: HttpClient, private journal: JournalService) {}
}
L'intérêt de inject() n'est pas esthétique : il fonctionne dans des endroits où un paramètre de constructeur est impossible — un initialiseur de champ, la fonction factory d'un InjectionToken, un guard ou un intercepteur fonctionnel, ou toute fonction utilitaire réutilisable qui a besoin d'une dépendance.
inject() n'est valable que dans un contexte d'injection : pendant la construction d'une classe gérée par le DI (constructeur, initialiseurs de champ), dans une fonction factory de provider, ou dans du code exécuté via runInInjectionContext(). En dehors — dans ngOnInit, un gestionnaire d'événement, un setTimeout, une méthode appelée plus tard — Angular lève l'erreur NG0203 : « inject() must be called from an injection context ».
export const authGuard: CanActivateFn = () => {
// les guards fonctionnels s'exécutent dans un contexte d'injection
return inject(AuthService).estConnecte();
};
Pour se désabonner automatiquement d'un Observable à la destruction, DestroyRef (et l'opérateur takeUntilDestroyed()) remplacent avantageusement ngOnDestroy dans du code fonctionnel. Les options { optional, self, skipSelf, host } affinent la recherche du provider dans la hiérarchie des injecteurs.
Les termes à connaître
- inject()
Fonction qui récupère une dépendance depuis l'injecteur actif, en dehors de la liste de paramètres d'un constructeur. Elle renvoie le même résultat que l'injection par constructeur, mais peut s'utiliser dans un initialiseur de champ, une fabrique de provider, un guard, un intercepteur, etc.
- Contexte d'injection
Fenêtre d'exécution pendant laquelle Angular sait quel injecteur utiliser : construction d'une classe gérée par le DI (constructeur, initialiseurs de champ), fonction
factoryd'un provider ou d'unInjectionToken, et tout code exécuté viarunInInjectionContext(). En dehors de ce contexte,inject()échoue.- runInInjectionContext()
Fonction qui exécute un callback en lui fournissant explicitement un contexte d'injection, à partir d'un
Injector(ouEnvironmentInjector) donné. Utile pour appelerinject()hors d'une classe gérée par le DI, par exemple dans un test ou un code asynchrone tardif.- DestroyRef
Service injectable qui expose
onDestroy(callback)pour enregistrer une action de nettoyage exécutée à la destruction du composant, de la directive ou du service courant. Alternative moderne àngOnDestroyquand on écrit une fonction utilitaire plutôt qu'une classe.- takeUntilDestroyed()
Opérateur RxJS qui complète automatiquement un
Observablequand le contexte appelant (composant, directive, service) est détruit. Appelé dans un contexte d'injection, il récupère leDestroyReftout seul ; sinon, il faut lui en passer un explicitement.- { optional: true }
Option de
inject()qui renvoienullau lieu de lever une erreur (NullInjectorError) quand aucun provider n'est trouvé pour le jeton demandé. Utile pour une dépendance qui n'existe que dans certains contextes (une feature chargée en différé, par exemple).- { self } / { skipSelf } / { host }
Options de
inject()qui contrôlent où chercher le provider dans la hiérarchie des injecteurs :selflimite la recherche à l'injecteur courant (sans remonter),skipSelfl'exclut et commence par le parent,hosts'arrête à la frontière de l'élément hôte d'une directive.
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.