Formations — 1 037 leçons en français

Accueil › Angular › Les jetons d'injection

Les jetons d'injection

Injection de dépendances avancéeintermediaire

Une classe injectable suffit la plupart du temps, mais pas toujours : une interface TypeScript n'existe plus à l'exécution (elle disparaît à la compilation), une valeur de configuration (URL d'API, taux de TVA par défaut) n'est pas une classe, et une API du navigateur (document, window) ne doit pas être référencée directement si le code doit aussi tourner côté serveur.

Pour ces cas, Angular fournit InjectionToken<T> : un objet qui sert de clé d'injection typée, indépendante de toute classe.

export interface ConfigPanier {
  tvaParDefaut: number;
  deviseParDefaut: string;
}

export const CONFIG_PANIER = new InjectionToken<ConfigPanier>('config.panier', {
  providedIn: 'root',
  factory: () => ({ tvaParDefaut: 0.2, deviseParDefaut: 'EUR' }),
});

L'option factory rend le jeton tree-shakable, comme un service providedIn: 'root' : la valeur n'est calculée qu'à la première injection, et éliminée du bundle si personne ne l'injecte jamais.

@Injectable({ providedIn: 'root' })
export class PanierService {
  private config = inject(CONFIG_PANIER);

  calculerTTC(montantHT: number) {
    return montantHT * (1 + this.config.tvaParDefaut);
  }
}

Angular fournit lui-même des jetons intégrés utiles : DOCUMENT (le Document courant, à la place de l'objet global document), LOCALE_ID (la locale active), PLATFORM_ID (identifie navigateur vs serveur, à combiner avec isPlatformBrowser()). Le même mécanisme de jeton permet aussi de remplacer une implémentation dans les tests, sans toucher au code de production.

Les termes à connaître

InjectionToken<T>

Objet qui sert de clé d'injection typée quand une classe ne convient pas (interface, valeur de configuration, API du navigateur). Créé avec new InjectionToken<T>('description', { providedIn, factory }), il se lit comme n'importe quelle dépendance avec inject(MON_JETON).

factory (d'un InjectionToken)

Fonction optionnelle passée à InjectionToken qui fournit une valeur par défaut, calculée seulement à la première injection (paresseuse) et tree-shakable : si le jeton n'est jamais injecté, ni la valeur ni ses dépendances n'atterrissent dans le bundle final.

DOCUMENT

Jeton d'injection (@angular/core depuis Angular 20 ; auparavant @angular/common) qui représente le Document du contexte de rendu courant. À injecter à la place d'un accès direct à l'objet global document, notamment pour que le code reste compatible avec le rendu côté serveur (SSR).

LOCALE_ID

Jeton d'injection qui donne la locale active de l'application (ex. 'fr-FR'), utilisée par les pipes de formatage (date, currency, number) et l'internationalisation. Se configure via un provider au bootstrap.

PLATFORM_ID

Jeton d'injection qui identifie la plateforme d'exécution courante (navigateur, serveur…). S'utilise presque toujours avec isPlatformBrowser() ou isPlatformServer() pour écrire du code conditionnel selon l'environnement.

isPlatformBrowser()

Fonction utilitaire (@angular/common) qui prend la valeur de PLATFORM_ID et renvoie true si le code s'exécute dans un navigateur. Indispensable avant d'utiliser une API propre au navigateur (window, localStorage…) dans une application qui peut aussi tourner en SSR.

Remplacement de provider en test

Dans TestBed.configureTestingModule({ providers: [...] }), remplacer le provider réel d'un jeton (classe ou InjectionToken) par une version simulée, sans toucher au code de production — c'est le même mécanisme de résolution de jeton qui rend ça possible.

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.