TestbedHarnessEnvironment — Angular

Реализация HarnessEnvironment для Testbed в Angular.

API

class TestbedHarnessEnvironment extends HarnessEnvironment<Element> {
  protected constructor(rawRootElement: Element, _fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions | undefined): TestbedHarnessEnvironment;
  forceStabilize(): Promise<void>;
  waitForTasksOutsideAngular(): Promise<void>;
  protected getDocumentRoot(): Element;
  protected createTestElement(element: Element): TestElement;
  protected createEnvironment(element: Element): HarnessEnvironment<Element>;
  protected getAllRawElements(selector: string): Promise<Element[]>;
  static loader(fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions | undefined): HarnessLoader;
  static documentRootLoader(fixture: ComponentFixture<unknown>, options?: TestbedHarnessEnvironmentOptions | undefined): HarnessLoader;
  static getNativeElement(el: TestElement): Element;
  static harnessForFixture<T extends ComponentHarness>(fixture: ComponentFixture<unknown>, harnessType: ComponentHarnessConstructor<T>, options?: TestbedHarnessEnvironmentOptions | undefined): Promise<T>;
}

constructor

TestbedHarnessEnvironment

@paramrawRootElementElement

@param_fixtureComponentFixture<unknown>

@paramoptionsTestbedHarnessEnvironmentOptions | undefined

@returnsTestbedHarnessEnvironment

forceStabilize

Promise<void>

Сбрасывает обнаружение изменений и асинхронные задачи, перехваченные в зоне Angular. В большинстве случаев вызывать этот метод вручную не требуется. Однако в некоторых особых случаях он может понадобиться, чтобы полностью обработать события анимации.

@returnsPromise<void>

waitForTasksOutsideAngular

Promise<void>

Ожидает завершения всех запланированных или выполняющихся асинхронных задач. Это позволяет авторам тестовых обвязок ожидать завершения асинхронных задач вне зоны Angular.

Это работает только при наличии Zone.js и применении патчей к тестовому фреймворку с помощью zone.js/testing (только Jasmine и Jest) или другого скрипта.

@returnsPromise<void>

getDocumentRoot

Element

Возвращает корневой элемент документа.

@returnsElement

createTestElement

TestElement

Создает TestElement из исходного элемента.

@paramelementElement

@returnsTestElement

createEnvironment

HarnessEnvironment<Element>

Создает HarnessLoader с корнем в указанном исходном элементе.

@paramelementElement

@returnsHarnessEnvironment<Element>

getAllRawElements

Promise<Element[]>

Возвращает список всех элементов, соответствующих указанному селектору и находящихся внутри корневого элемента этой среды.

@paramselectorstring

@returnsPromise<Element[]>

loader

HarnessLoader

Создает HarnessLoader с корнем в корневом элементе указанной тестовой фикстуры.

@paramfixtureComponentFixture<unknown>

@paramoptionsTestbedHarnessEnvironmentOptions | undefined

@returnsHarnessLoader

documentRootLoader

HarnessLoader

Создает HarnessLoader в корне документа. Этот метод можно использовать, если тестовые обвязки находятся вне тестовой фикстуры (например, оверлеи, добавленные в тело документа).

@paramfixtureComponentFixture<unknown>

@paramoptionsTestbedHarnessEnvironmentOptions | undefined

@returnsHarnessLoader

getNativeElement

Element

Возвращает нативный элемент DOM, соответствующий указанному TestElement.

@paramelTestElement

@returnsElement

harnessForFixture

Promise<T>

Создает экземпляр указанного типа тестовой обвязки, используя корневой элемент тестовой фикстуры в качестве хост-элемента этой обвязки. Этот метод следует использовать при создании тестовой обвязки для корневого элемента фикстуры, поскольку у компонентов, созданных в качестве корня фикстуры, неверный селектор.

@paramfixtureComponentFixture<unknown>

@paramharnessTypeComponentHarnessConstructor<T>

@paramoptionsTestbedHarnessEnvironmentOptions | undefined

@returnsPromise<T>