bootstrapApplication — Angular

Запускает экземпляр приложения Angular и отображает автономный компонент в качестве корневого компонента приложения. Подробнее об автономных компонентах можно узнать в этом руководстве.

API

function bootstrapApplication(
  rootComponent: Type<unknown>,
  options?: ApplicationConfig | undefined,
  context?: BootstrapContext | undefined,
): Promise<ApplicationRef>;

@paramrootComponentType<unknown>

Ссылка на автономный компонент, который нужно отобразить.

@paramoptionsApplicationConfig | undefined

Дополнительная конфигурация для запуска приложения. Дополнительную информацию см. в разделе ApplicationConfig.

@paramcontextBootstrapContext | undefined

Необязательный объект контекста, который можно использовать для предоставления существующего инжектора платформы. Это полезно в сложных сценариях, например при рендеринге на стороне сервера, когда платформа создается для каждого запроса.

@returnsPromise<ApplicationRef>

Обещание, которое после выполнения возвращает экземпляр ApplicationRef.

Примечания по использованию

Корневой компонент, передаваемый этой функции, должен быть автономным.

@Component({
  template: 'Hello world!'
})
class Root {}

const appRef: ApplicationRef = await bootstrapApplication(Root);

Список провайдеров, доступных в инжекторе приложения, можно добавить, указав поле providers в объекте, передаваемом в качестве второго аргумента:

await bootstrapApplication(Root, {
  providers: [
    {provide: BACKEND_URL, useValue: 'https://yourdomain.com/api'}
  ]
});

Вспомогательный метод importProvidersFrom позволяет собрать все провайдеры из любого существующего NgModule (а также транзитивно из всех импортируемых им NgModule):

await bootstrapApplication(Root, {
  providers: [
    importProvidersFrom(SomeNgModule)
  ]
});

Примечание: по умолчанию метод bootstrapApplication не включает Testability. Добавить Testability можно, получив список необходимых провайдеров с помощью функции provideProtractorTestingSupport() и добавив их в массив providers, например:

import {provideProtractorTestingSupport} from '@angular/platform-browser';

await bootstrapApplication(Root, {providers: [provideProtractorTestingSupport()]});