UnitTestElement — Angular

Реализация TestElement для модульных тестов.

API

class UnitTestElement implements TestElement {
  constructor(element: Element, _stabilize: () => Promise<void>): UnitTestElement;
  blur(): Promise<void>;
  clear(): Promise<void>;
  click(modifiers?: any): Promise<void>;
  click(location: "center", modifiers?: any): Promise<void>;
  click(relativeX: number, relativeY: number, modifiers?: any): Promise<void>;
  rightClick(relativeX: number, relativeY: number, modifiers?: any): Promise<void>;
  focus(): Promise<void>;
  getCssValue(property: string): Promise<string>;
  hover(): Promise<void>;
  mouseAway(): Promise<void>;
  sendKeys(...keys: any[]): Promise<void>;
  sendKeys(modifiers: ModifierKeys, ...keys: any[]): Promise<void>;
  text(options?: any): Promise<string>;
  setContenteditableValue(value: string): Promise<void>;
  getAttribute(name: string): Promise<string | null>;
  hasClass(name: string): Promise<boolean>;
  getDimensions(): Promise<ElementDimensions>;
  getProperty<T = any>(name: string): Promise<T>;
  setInputValue(value: string): Promise<void>;
  selectOptions(...optionIndexes: number[]): Promise<void>;
  matchesSelector(selector: string): Promise<boolean>;
  isFocused(): Promise<boolean>;
  dispatchEvent(name: string, data?: Record<string, EventData> | undefined): Promise<void>;
}

constructor

UnitTestElement

@paramelementElement

@param_stabilize() => Promise<void>

@returnsUnitTestElement

blur

Promise<void>

Снимает фокус с элемента.

@returnsPromise<void>

clear

Promise<void>

Очищает поле ввода элемента (только для элементов input и textarea).

@returnsPromise<void>

click

3 перегрузки

Щелкает по элементу в стандартном для текущего окружения месте. Если необходимо гарантировать щелчок по элементу в определенном месте, рассмотрите возможность использовать вместо этого click('center') или click(x, y).

@parammodifiersany

@returnsPromise<void>

Щелкает по центру элемента.

@paramlocation"center"

@parammodifiersany

@returnsPromise<void>

Щелкает по элементу в заданных координатах относительно его верхнего левого угла.

@paramrelativeXnumber

Координата внутри элемента по оси X, в которой нужно щелкнуть.

@paramrelativeYnumber

Координата внутри элемента по оси Y, в которой нужно щелкнуть.

@parammodifiersany

Клавиши-модификаторы, удерживаемые во время щелчка

@returnsPromise<void>

rightClick

Promise<void>

Щелкает правой кнопкой мыши по элементу в заданных координатах относительно его верхнего левого угла.

@paramrelativeXnumber

Координата внутри элемента по оси X, в которой нужно щелкнуть.

@paramrelativeYnumber

Координата внутри элемента по оси Y, в которой нужно щелкнуть.

@parammodifiersany

Клавиши-модификаторы, удерживаемые во время щелчка

@returnsPromise<void>

focus

Promise<void>

Устанавливает фокус на элемент.

@returnsPromise<void>

getCssValue

Promise<string>

Возвращает вычисленное значение указанного свойства CSS для элемента.

@parampropertystring

@returnsPromise<string>

hover

Promise<void>

Наводит указатель мыши на элемент.

@returnsPromise<void>

mouseAway

Promise<void>

Перемещает указатель мыши за пределы элемента.

@returnsPromise<void>

sendKeys

2 перегрузки

Отправляет указанную строку в поле ввода в виде последовательности нажатий клавиш. Также генерирует события input и пытается добавить строку в значение элемента. Обратите внимание, что этот метод не может воспроизвести стандартное поведение браузера для сочетаний клавиш, таких как Tab, Ctrl + A и т. д.

@paramkeysany[]

@returnsPromise<void>

Отправляет указанную строку в поле ввода в виде последовательности нажатий клавиш. Также генерирует события input и пытается добавить строку в значение элемента.

@parammodifiersModifierKeys

@paramkeysany[]

@returnsPromise<void>

text

Promise<string>

Получает текст элемента.

@paramoptionsany

Параметры, определяющие, какой текст включать.

@returnsPromise<string>

setContenteditableValue

Promise<void>

Задает значение элемента contenteditable.

@paramvaluestring

Значение, которое нужно задать для элемента.

@returnsPromise<void>

getAttribute

Promise<string | null>

Получает значение указанного атрибута элемента.

@paramnamestring

@returnsPromise<string | null>

hasClass

Promise<boolean>

Проверяет, есть ли у элемента указанный класс.

@paramnamestring

@returnsPromise<boolean>

getDimensions

Promise<ElementDimensions>

Получает размеры элемента.

@returnsPromise<ElementDimensions>

getProperty

Promise<T>

Получает значение свойства элемента.

@paramnamestring

@returnsPromise<T>

setInputValue

Promise<void>

Задает значение свойства поля ввода.

@paramvaluestring

@returnsPromise<void>

selectOptions

Promise<void>

Выбирает параметры с указанными индексами в нативном элементе select.

@paramoptionIndexesnumber[]

@returnsPromise<void>

matchesSelector

Promise<boolean>

Проверяет, соответствует ли этот элемент указанному селектору.

@paramselectorstring

@returnsPromise<boolean>

isFocused

Promise<boolean>

Проверяет, находится ли элемент в фокусе.

@returnsPromise<boolean>

dispatchEvent

Promise<void>

Отправляет событие с указанным именем.

@paramnamestring

Имя отправляемого события.

@paramdataRecord<string, EventData> | undefined

@returnsPromise<void>