@angular/core

APP_INITIALIZER

constant

A DI token that you can use to provide one or more initialization functions.

const APP_INITIALIZER: InjectionToken<readonly (() => void | Observable<unknown> | Promise<unknown>)[]>;

A DI token that you can use to provide one or more initialization functions.

The provided functions are injected at application startup and executed during app initialization. If any of these functions returns a Promise or an Observable, initialization does not complete until the Promise is resolved or the Observable is completed.

You can, for example, create a factory function that loads language data or an external configuration, and provide that function to the APP_INITIALIZER token. The function is executed during the application bootstrap process, and the needed data is available on startup.

The following example illustrates how to configure a multi-provider using APP_INITIALIZER token and a function returning a promise.

Example with NgModule-based application

          
             function initializeApp(): Promise<any> {   return new Promise((resolve, reject) => {     // Do some asynchronous stuff     resolve();   }); } @NgModule({  imports: [BrowserModule],  declarations: [AppComponent],  bootstrap: [AppComponent],  providers: [{    provide: APP_INITIALIZER,    useFactory: () => initializeApp,    multi: true   }]  }) export class AppModule {}

Example with standalone application

          
            export function initializeApp(http: HttpClient) {  return (): Promise<any> =>    firstValueFrom(      http        .get("https://someUrl.com/api/user")        .pipe(tap(user => { ... }))    );}bootstrapApplication(App, {  providers: [    provideHttpClient(),    {      provide: APP_INITIALIZER,      useFactory: initializeApp,      multi: true,      deps: [HttpClient],    },  ],});

It's also possible to configure a multi-provider using APP_INITIALIZER token and a function returning an observable, see an example below. Note: the HttpClient in this example is used for demo purposes to illustrate how the factory function can work with other providers available through DI.

Example with NgModule-based application

          
             function initializeAppFactory(httpClient: HttpClient): () => Observable<any> {  return () => httpClient.get("https://someUrl.com/api/user")    .pipe(       tap(user => { ... })    ); } @NgModule({   imports: [BrowserModule, HttpClientModule],   declarations: [AppComponent],   bootstrap: [AppComponent],   providers: [{     provide: APP_INITIALIZER,     useFactory: initializeAppFactory,     deps: [HttpClient],     multi: true   }] }) export class AppModule {}

Example with standalone application

          
             function initializeAppFactory(httpClient: HttpClient): () => Observable<any> {  return () => httpClient.get("https://someUrl.com/api/user")    .pipe(       tap(user => { ... })    ); }bootstrapApplication(App, {  providers: [    provideHttpClient(),    {      provide: APP_INITIALIZER,      useFactory: initializeAppFactory,      multi: true,      deps: [HttpClient],    },  ],});