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 avecinject(MON_JETON).- factory (d'un InjectionToken)
Fonction optionnelle passée à
InjectionTokenqui 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/coredepuis Angular 20 ; auparavant@angular/common) qui représente leDocumentdu contexte de rendu courant. À injecter à la place d'un accès direct à l'objet globaldocument, 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()ouisPlatformServer()pour écrire du code conditionnel selon l'environnement.- isPlatformBrowser()
Fonction utilitaire (
@angular/common) qui prend la valeur dePLATFORM_IDet renvoietruesi 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 ouInjectionToken) 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.
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.