W3cubDocs

/Angular

InjectionToken

class final

Creates a token that can be used in a DI Provider.

See more...

class InjectionToken<T> {
  constructor(_desc: string, options?: { providedIn?: "root" | Type<any> | "platform" | "any"; factory: () => T; })
  protected _desc: string
  toString(): string
}

Description

Use an InjectionToken whenever the type you are injecting is not reified (does not have a runtime representation) such as when injecting an interface, callable type, array or parameterized type.

InjectionToken is parameterized on T which is the type of object which will be returned by the Injector. This provides an additional level of type safety.

interface MyInterface {...}
const myInterface = injector.get(new InjectionToken<MyInterface>('SomeToken'));
// myInterface is inferred to be MyInterface.

When creating an InjectionToken, you can optionally specify a factory function which returns (possibly by creating) a default value of the parameterized type T. This sets up the InjectionToken using this factory as a provider as if it was defined explicitly in the application's root injector. If the factory function, which takes zero arguments, needs to inject dependencies, it can do so using the inject function. As you can see in the Tree-shakable InjectionToken example below.

Additionally, if a factory is specified you can also specify the providedIn option, which overrides the above behavior and marks the token as belonging to a particular @NgModule (note: this option is now deprecated). As mentioned above, 'root' is the default value for providedIn.

The providedIn: NgModule and providedIn: 'any' options are deprecated.

Further information is available in the Usage Notes...

Constructor

constructor(_desc: string, options?: { providedIn?: "root" | Type<any> | "platform" | "any"; factory: () => T; })

Parameters
_desc string

Description for the token, used only for debugging purposes, it should but does not need to be unique

options object

Options for the token's usage, as described above

Optional. Default is undefined.

Properties

Property Description
protected _desc: string Declared in Constructor

Description for the token, used only for debugging purposes, it should but does not need to be unique

Methods

toString(): string

Parameters

There are no parameters.

Returns

string

Usage notes

Basic Examples

Plain InjectionToken

const BASE_URL = new InjectionToken<string>('BaseUrl');
const injector =
    Injector.create({providers: [{provide: BASE_URL, useValue: 'http://localhost'}]});
const url = injector.get(BASE_URL);
// Note: since `BASE_URL` is `InjectionToken<string>`
// `url` is correctly inferred to be `string`
expect(url).toBe('http://localhost');

Tree-shakable InjectionToken

class MyService {
  constructor(readonly myDep: MyDep) {}
}

const MY_SERVICE_TOKEN = new InjectionToken<MyService>('Manually constructed MyService', {
  providedIn: 'root',
  factory: () => new MyService(inject(MyDep)),
});

const instance = injector.get(MY_SERVICE_TOKEN);
expect(instance instanceof MyService).toBeTruthy();
expect(instance.myDep instanceof MyDep).toBeTruthy();

© 2010–2023 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://angular.io/api/core/InjectionToken