依存性の注入 (DI) システムは、内部的に現在のインジェクターが利用可能なランタイムコンテキストに依存しています。 これは、インジェクターは、このようなコンテキストでコードが実行される場合にのみ動作することを意味します。
注入コンテキストは、次の状況で使用できます。
- DIシステムによってインスタンス化されるクラス（
@Injectableまたは@Componentなど）の構築（constructorを使用）中。 - このようなクラスのフィールドのイニシャライザー。
Providerまたは@InjectableのuseFactoryに指定されたファクトリー関数。InjectionTokenに指定されたfactory関数。- 注入コンテキストで実行されるスタックフレーム内。
注入コンテキストにいるかどうかを知ることで、inject 関数を使用してインスタンスを注入できます。
クラスコンストラクター
DIシステムがクラスをインスタンス化するたびに、注入コンテキスト内でインスタンス化されます。これは、フレームワーク自体によって処理されます。クラスのコンストラクターは、そのランタイムコンテキストで実行され、これにより inject 関数を使用してトークンを注入できます。
class MyComponent { private service1: Service1; private service2: Service2 = inject(Service2); // コンテキスト内 constructor() { this.service1 = inject(Service1) // コンテキスト内 }}
コンテキスト内のスタックフレーム
一部のAPIは、注入コンテキストで実行されるように設計されています。これは、たとえば、ルーターガードの場合です。これにより、ガード関数内で inject を使用してサービスにアクセスできます。
CanActivateFn の例を次に示します。
const canActivateTeam: CanActivateFn = (route: ActivatedRouteSnapshot, state: RouterStateSnapshot) => { return inject(PermissionsService).canActivate(inject(UserToken), route.params.id); };
注入コンテキスト内で実行する
すでに注入コンテキスト内にいない状態で、特定の関数を注入コンテキスト内で実行したい場合は、runInInjectionContext を使用できます。
これには、たとえば EnvironmentInjector のような特定のインジェクターへのアクセスが必要です。
src/app/heroes/hero.service.ts
@Injectable({ providedIn: 'root',})export class HeroService { private environmentInjector = inject(EnvironmentInjector); someMethod() { runInInjectionContext(this.environmentInjector, () => { inject(SomeService); // 注入されたサービスで必要な処理を行います }); }}
inject は、インジェクターが要求されたトークンを解決できる場合にのみインスタンスを返します。
コンテキストのアサート
Angularは、現在のコンテキストが注入コンテキストであることをアサートするための assertInInjectionContext ヘルパー関数を提供します。
コンテキスト外での DI の使用
注入コンテキスト外で inject を呼び出したり、assertInInjectionContext を呼び出したりすると、エラー NG0203 がスローされます。