Formations — 1 037 leçons en français

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 factory d'un provider ou d'un InjectionToken, et tout code exécuté via runInInjectionContext(). 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 (ou EnvironmentInjector) donné. Utile pour appeler inject() 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 à ngOnDestroy quand on écrit une fonction utilitaire plutôt qu'une classe.

takeUntilDestroyed()

Opérateur RxJS qui complète automatiquement un Observable quand le contexte appelant (composant, directive, service) est détruit. Appelé dans un contexte d'injection, il récupère le DestroyRef tout seul ; sinon, il faut lui en passer un explicitement.

{ optional: true }

Option de inject() qui renvoie null au 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 : self limite la recherche à l'injecteur courant (sans remonter), skipSelf l'exclut et commence par le parent, host s'arrête à la frontière de l'élément hôte d'une directive.

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.