TestElement — Angular

Этот интерфейс служит общим интерфейсом для DOM-элементов в модульных тестах и сквозных тестах. Через него ComponentHarness взаимодействует с DOM компонента.

API

interface TestElement {
  blur(): Promise<void>;
  clear(): Promise<void>;
  click(modifiers?: ModifierKeys | undefined): Promise<void>;
  click(location: "center", modifiers?: ModifierKeys | undefined): Promise<void>;
  click(relativeX: number, relativeY: number, modifiers?: ModifierKeys | undefined): Promise<void>;
  rightClick(relativeX: number, relativeY: number, modifiers?: ModifierKeys | undefined): Promise<void>;
  focus(): Promise<void>;
  getCssValue(property: string): Promise<string>;
  hover(): Promise<void>;
  mouseAway(): Promise<void>;
  sendKeys(...keys: (string | TestKey)[]): Promise<void>;
  sendKeys(modifiers: ModifierKeys, ...keys: (string | TestKey)[]): Promise<void>;
  text(options?: TextOptions | undefined): 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>;
  matchesSelector(selector: string): Promise<boolean>;
  isFocused(): Promise<boolean>;
  setInputValue(value: string): Promise<void>;
  selectOptions(...optionIndexes: number[]): Promise<void>;
  dispatchEvent(name: string, data?: Record<string, EventData> | undefined): Promise<void>;
}

blur

Promise<void>

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

@returnsPromise<void>

clear

Promise<void>

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

@returnsPromise<void>

click

Promise<void>

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

@parammodifiersModifierKeys | undefined

@returnsPromise<void>

click

Promise<void>

Нажимает на элемент в его центре.

@paramlocation"center"

@parammodifiersModifierKeys | undefined

@returnsPromise<void>

click

Promise<void>

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

@paramrelativeXnumber

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

@paramrelativeYnumber

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

@parammodifiersModifierKeys | undefined

Клавиши-модификаторы, зажатые во время нажатия

@returnsPromise<void>

rightClick

Promise<void>

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

@paramrelativeXnumber

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

@paramrelativeYnumber

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

@parammodifiersModifierKeys | undefined

Клавиши-модификаторы, зажатые во время нажатия

@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

Promise<void>

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

@paramkeys(string | TestKey)[]

@returnsPromise<void>

sendKeys

Promise<void>

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

@parammodifiersModifierKeys

@paramkeys(string | TestKey)[]

@returnsPromise<void>

text

Promise<string>

Возвращает текст элемента.

@paramoptionsTextOptions | undefined

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

@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>

matchesSelector

Promise<boolean>

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

@paramselectorstring

@returnsPromise<boolean>

isFocused

Promise<boolean>

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

@returnsPromise<boolean>

setInputValue

Promise<void>

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

@paramvaluestring

@returnsPromise<void>

selectOptions

Promise<void>

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

@paramoptionIndexesnumber[]

@returnsPromise<void>

dispatchEvent

Promise<void>

Генерирует событие с указанным именем.

@paramnamestring

Имя генерируемого события.

@paramdataRecord<string, EventData> | undefined

@returnsPromise<void>