Вспомогательные API для тестирования

На этой странице описаны наиболее полезные возможности Angular для тестирования.

Вспомогательные средства Angular для тестирования включают TestBed, ComponentFixture и несколько функций, управляющих тестовой средой. Классы TestBed и ComponentFixture рассматриваются отдельно.

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

Сведения об обработке сложных асинхронных сценариев и тестировании устаревших приложений на основе Zone.js см. в руководстве Вспомогательные средства тестирования Zone.js.

Краткое описание класса TestBed

Класс TestBed — одно из основных вспомогательных средств Angular для тестирования. Его API довольно обширен и может показаться сложным, пока вы не изучите его понемногу. Сначала прочитайте начало этого руководства, чтобы освоить основы, и только потом переходите к изучению всего API.

Определение модуля, передаваемое в configureTestingModule, представляет собой подмножество свойств метаданных @NgModule.

type TestModuleMetadata = {
  providers?: any[];
  declarations?: any[];
  imports?: any[];
  schemas?: Array<SchemaMetadata | any[]>;
};

Каждый метод переопределения принимает MetadataOverride<T>, где T — тип метаданных, соответствующий методу, то есть параметр @NgModule, @Component, @Directive или @Pipe.

type MetadataOverride<T> = {
  add?: Partial<T>;
  remove?: Partial<T>;
  set?: Partial<T>;
};

API TestBed состоит из статических методов класса, которые обновляют или используют глобальный экземпляр TestBed.

Внутри все статические методы охватывают методы текущего экземпляра TestBed во время выполнения; этот экземпляр также возвращается функцией getTestBed().

Вызывайте методы TestBed внутри beforeEach(), чтобы каждый отдельный тест начинался с чистого состояния.

Ниже приведены наиболее важные статические методы, расположенные в порядке их предполагаемой полезности.

| inject | Получает службу из инжектора текущего TestBed. Для этой цели часто достаточно функции inject. Но inject выдаёт ошибку, если не может предоставить службу.
Что делать, если служба необязательна?
Метод TestBed.inject() принимает необязательный второй параметр — объект, который нужно вернуть, если Angular не найдёт поставщика (в этом примере это null): expect(TestBed.inject(NotProvided, null)).toBeNull(); После вызова TestBed.inject конфигурация TestBed замораживается на время текущей спецификации. | | initTestEnvironment | Инициализирует тестовую среду для всего запуска тестов.
Вспомогательные средства тестирования вызывают этот метод за вас, поэтому обычно нет необходимости вызывать его самостоятельно.
Вызывайте этот метод ровно один раз. Чтобы изменить это значение по умолчанию в ходе запуска тестов, сначала вызовите resetTestEnvironment.
Укажите фабрику компилятора Angular, PlatformRef и модуль тестирования Angular по умолчанию. Варианты для небраузерных платформ доступны в общей форме @angular/platform-<platform_name>/testing/<platform_name>. | | resetTestEnvironment | Сбрасывает начальную тестовую среду, включая модуль тестирования по умолчанию. |

Некоторые методы экземпляра TestBed не охватываются статическими методами класса TestBed. Они нужны редко.

ComponentFixture

TestBed.createComponent<T> создаёт экземпляр компонента T и возвращает типизированный объект ComponentFixture для этого компонента.

Свойства и методы ComponentFixture обеспечивают доступ к компоненту, его представлению в DOM и различным аспектам его среды Angular.

Свойства ComponentFixture

Ниже приведены наиболее важные для тестирования свойства, расположенные в порядке их предполагаемой полезности.

Методы ComponentFixture

Методы fixture заставляют Angular выполнять определённые действия над деревом компонентов. Вызывайте эти методы, чтобы запускать поведение Angular в ответ на имитацию действий пользователя.

Ниже приведены наиболее полезные методы для тестирования.

DebugElement

DebugElement позволяет получить важные сведения о представлении DOM компонента.

Начиная с корневого компонента теста, объект DebugElement которого возвращается вызовом fixture.debugElement, можно пройти по всему дереву элементов и компонентов fixture и выполнять по нему запросы.

Ниже приведены наиболее полезные для тестирования члены DebugElement, расположенные примерно в порядке их полезности:

Методы DebugElement.query(predicate) и DebugElement.queryAll(predicate) принимают предикат, который фильтрует поддерево исходного элемента и находит соответствующие объекты DebugElement.

Предикат — это любой метод, который принимает DebugElement и возвращает истинное значение. В следующем примере находятся все DebugElements со ссылкой на локальную переменную шаблона с именем "content":

// Filter for DebugElements with a #content reference
const contentRefs = el.queryAll((de) => de.references['content']);

Класс Angular By содержит три статических метода для часто используемых предикатов:

// Can find DebugElement either by css selector or by directive
const h2 = fixture.debugElement.query(By.css('h2'));
const directive = fixture.debugElement.query(By.directive(Highlight));