Angular Dependency Injection

Angular v20+ で inject() とプロバイダーを使用して依存性注入を設定し使用します。

基本的な注入

inject() の使用

コンストラクタ注入より inject() を推奨します:

import { Component, inject } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { User } from './user.service';

@Component({
  selector: 'app-user-list',
  template: `...`,
})
export class UserList {
  // 依存性を注入
  private http = inject(HttpClient);
  private userService = inject(User);
  
  // すぐに使用可能
  users = this.userService.getUsers();
}

Injectable サービス

import { Injectable, inject, signal } from '@angular/core';
import { HttpClient } from '@angular/common/http';

@Injectable({
  providedIn: 'root', // ルートレベルのシングルトン
})
export class User {
  private http = inject(HttpClient);
  
  private users = signal<User[]>([]);
  readonly users$ = this.users.asReadonly();
  
  async loadUsers() {
    const users = await firstValueFrom(
      this.http.get<User[]>('/api/users')
    );
    this.users.set(users);
  }
}

プロバイダースコープ

ルートレベル (シングルトン)

// 推奨: providedIn
@Injectable({
  providedIn: 'root',
})
export class Auth {}

// 別の方法: app.config.ts で設定
export const appConfig: ApplicationConfig = {
  providers: [
    Auth,
  ],
};

コンポーネントレベル (コンポーネントごとにインスタンス)

@Component({
  selector: 'app-editor',
  providers: [EditorState], // 各コンポーネントで新しいインスタンス
  template: `...`,
})
export class Editor {
  private editorState = inject(EditorState);
}

ルートレベル

export const routes: Routes = [
  {
    path: 'admin',
    providers: [Admin], // このルートツリー内で共有
    children: [
      { path: '', component: AdminDashboard },
      { path: 'users', component: AdminUsers },
    ],
  },
];

Injection Tokens

トークンの作成

import { InjectionToken } from '@angular/core';

// シンプルな値トークン
export const API_URL = new InjectionToken<string>('API_URL');

// オブジェクトトークン
export interface AppConfig {
  apiUrl: string;
  features: {
    darkMode: boolean;
    analytics: boolean;
  };
}

export const APP_CONFIG = new InjectionToken<AppConfig>('APP_CONFIG');

// ファクトリ付きトークン (自己提供)
export const WINDOW = new InjectionToken<Window>('Window', {
  providedIn: 'root',
  factory: () => window,
});

export const LOCAL_STORAGE = new InjectionToken<Storage>('LocalStorage', {
  providedIn: 'root',
  factory: () => localStorage,
});

トークン値の提供

// app.config.ts
export const appConfig: ApplicationConfig = {
  providers: [
    { provide: API_URL, useValue: 'https://api.example.com' },
    {
      provide: APP_CONFIG,
      useValue: {
        apiUrl: 'https://api.example.com',
        features: { darkMode: true, analytics: true },
      },
    },
  ],
};

トークンの注入

@Injectable({ providedIn: 'root' })
export class Api {
  private apiUrl = inject(API_URL);
  private config = inject(APP_CONFIG);
  private window = inject(WINDOW);
  
  getBaseUrl(): string {
    return this.apiUrl;
  }
}

プロバイダータイプ

useClass

// 実装を提供
{ provide: Logger, useClass: ConsoleLogger }

// 条件付きで実装を選択
{
  provide: Logger,
  useClass: environment.production
    ? ProductionLogger
    : ConsoleLogger,
}

useValue

// 静的な値
{ provide: API_URL, useValue: 'https://api.example.com' }

// 設定オブジェクト
{ provide: APP_CONFIG, useValue: { theme: 'dark', language: 'en' } }

useFactory

// 依存性を持つファクトリ
{
  provide: User,
  useFactory: (http: HttpClient, config: AppConfig) => {
    return new User(http, config.apiUrl);
  },
  deps: [HttpClient, APP_CONFIG],
}

// 非同期ファクトリ (非推奨 - provideAppInitializer を使用)
{
  provide: CONFIG,
  useFactory: () => fetch('/config.json').then(r => r.json()),
}

useExisting

// 既存のプロバイダーへのエイリアス
{ provide: AbstractLogger, useExisting: ConsoleLogger }

// 複数のトークンが同じインスタンスを指す
providers: [
  ConsoleLogger,
  { provide: Logger, useExisting: ConsoleLogger },
  { provide: ErrorLogger, useExisting: ConsoleLogger },
]

注入オプション

オプション注入

@Component({...})
export class My {
  // 提供されていない場合は null を返す
  private analytics = inject(Analytics, { optional: true });
  
  trackEvent(name: string) {
    this.analytics?.track(name);
  }
}

Self、SkipSelf、Host

@Component({
  providers: [Local],
})
export class Parent {
  // このコンポーネントのインジェクターのみで探索
  private local = inject(Local, { self: true });
}

@Component({...})
export class Child {
  // このコンポーネントをスキップして親で探索
  private parentService = inject(ParentSvc, { skipSelf: true });

  // ホストコンポーネントまでのみ探索
  private hostService = inject(Host, { host: true });
}

マルチプロバイダー

同じトークンで複数の値を集める:

// 複数のバリデーターのトークン
export const VALIDATORS = new InjectionToken<Validator[]>('Validators');

// 複数の値を提供
providers: [
  { provide: VALIDATORS, useClass: RequiredValidator, multi: true },
  { provide: VALIDATORS, useClass: EmailValidator, multi: true },
  { provide: VALIDATORS, useClass: MinLengthValidator, multi: true },
]

// 配列として注入
@Injectable()
export class Validation {
  private validators = inject(VALIDATORS); // Validator[]
  
  validate(value: string): ValidationError[] {
    return this.validators
      .map(v => v.validate(value))
      .filter(Boolean);
  }
}

HTTP インターセプター (マルチプロバイダー)

// インターセプターは内部的にマルチプロバイダーを使用
export const appConfig: ApplicationConfig = {
  providers: [
    provideHttpClient(
      withInterceptors([
        authInterceptor,
        loggingInterceptor,
        errorInterceptor,
      ])
    ),
  ],
};

アプリケーションイニシャライザー

provideAppInitializer を使用してアプリ起動前に非同期コードを実行:

import { provideAppInitializer, inject } from '@angular/core';

export const appConfig: ApplicationConfig = {
  providers: [
    Config,
    provideAppInitializer(() => {
      const configService = inject(Config);
      return configService.loadConfig();
    }),
  ],
};

複数のイニシャライザー

providers: [
  provideAppInitializer(() => {
    const config = inject(Config);
    return config.load();
  }),
  provideAppInitializer(() => {
    const auth = inject(Auth);
    return auth.checkSession();
  }),
]

Environment Injector

プログラマティックにインジェクターを作成:

import { createEnvironmentInjector, EnvironmentInjector, inject } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class Plugin {
  private parentInjector = inject(EnvironmentInjector);
  
  loadPlugin(providers: Provider[]): EnvironmentInjector {
    return createEnvironmentInjector(providers, this.parentInjector);
  }
}

runInInjectionContext

注入コンテキストを持つコードを実行:

import { runInInjectionContext, EnvironmentInjector, inject } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class Utility {
  private injector = inject(EnvironmentInjector);
  
  executeWithDI<T>(fn: () => T): T {
    return runInInjectionContext(this.injector, fn);
  }
}

// 使用例
utilityService.executeWithDI(() => {
  const http = inject(HttpClient);
  // http を使用...
});

高度なパターンについては、references/di-patterns.md を参照してください。