Справочник элементов

Шаг автотеста

Шаг автотеста ​

Шаг автотеста - одно действие Playwright внутри автотеста. У шага есть action_name, необязательный Target, необязательный Value, необязательный timeout_ms и при необходимости expected_value.

На карточке автотеста шаги показываются в виде Панель или Карточки. Как переключить и когда остаётся только карточки: Составление шагов автотеста.

Источник истины правил действий - файл данных autotest-actions.json в репозитории документации (каталог app/src/.vitepress/data/). Инструкции по каждому действию: /ru/autotests/actions/{action_name}.

Связи ​

Связанный элементКак связан
АвтотестОбязательный родитель
Элемент / страницаНеобязательный Target из репозитория объектов
Тестовый аккаунтЧерез источник Value TEST_ACCOUNT у выполняемого CASE

Поля модели ​

НазваниеТехническое имяСмысл
Действиеaction_nameИмя из каталога (41 действие)
TargetTargetЭлемент/страница репозитория или локатор на шаге
ValueValue / value_textТекст, путь, URL, клавиша, имя атрибута, число, класс, id, свойство CSS или заголовок вкладки - по действию
Источник Valuevalue_source_typeINLINE, TEST_ACCOUNT или RUN_PARAMETER
Поле аккаунтаvalue_source_fieldlogin или password при TEST_ACCOUNT
Таймаутtimeout_msНеобязательный лимит ожидания/проверки в мс
Ожидаемое значениеexpected_valueДля toHaveAttribute - ожидаемое содержимое атрибута, можно не заполнять. Для toHaveCSS - вычисленное значение свойства, обязательно

Таблицы полей как проекция схемы появятся после артефакта схемы на пути проверки запроса. До этого ориентир - каталог действий ниже и SDK.

Виды локатора Target ​

Литералы kind - только UPPERCASE:

kindСмыслВ интерфейсе
ROLEAccessibility role; при необходимости имя (name)Role
LABELСвязанный label поля (label / accessible name поля ввода)Label
PLACEHOLDERPlaceholderPlaceholder
TESTIDTest idTest id
TEXTВидимый текст на странице (не label поля)Text
TITLEАтрибут titleTitle
ALTАльтернативный текст изображенияAlt
CSSCSS-селекторCSS
IDАтрибут idID
NAMEАтрибут nameName
XPATHXPathXPath
SELECTORСелектор в общем видеSelector

В селекте Искать по не путайте LABEL и TEXT:

ВыбратьКогда
LABEL (Label)Цель - поле/контрол по его label (например «Email», «Пароль» у input)
TEXT (Text)Цель - элемент по видимому тексту на экране (кнопка «Сохранить», заголовок, ссылка)

Подписи в селекте - оригинальные английские слова Playwright (Role, Label, Text), на всех локалях интерфейса одинаково. Литерал в JSON и API всегда UPPERCASE (LABEL, TEXT).

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

Target также может ссылаться на запись репозитория объектов вместо локатора на шаге. Подробнее: Привязка Target из репозитория объектов.

Источники Value ​

ЗначениеСмысл
INLINEТекст хранится в шаге
TEST_ACCOUNTВоркер берёт поле login или password аккаунта выполняемого CASE
RUN_PARAMETERValue - шаблон. <<имя>> заменяется значением параметра запуска с этим именем

Поля тестового аккаунта для источника: login, password. Инструкция: Значения из тестового аккаунта в шагах.

RUN_PARAMETER нельзя сочетать со страницей репозитория на том же шаге. Токен <<имя>> в этом случае пишите в Путь страницы, а шаг оставьте привязанным к странице. Тот же токен в Значении локатора или Доступном имени элемента заменяется, когда шаг использует этот элемент. Имена собираются по всему проекту и заполняются в блоке Параметры запуска при создании запуска. См. Создание запуска автотестов.

Правила каталога ​

  • Скриншот не является шагом. Параметры запуска (Скриншот при ошибке, Скриншот результата) - не action_name. Типичные ложные падения шагов: Как задавать шаги автотеста без ложных падений.
  • TEST_ACCOUNT нельзя сочетать с Target-страницей репозитория на том же шаге.
  • TEST_ACCOUNT запрещён для goto, waitForURL, toHaveURL, waitForTimeout.
  • Не кликайте ссылки с новой вкладкой (target=_blank): откройте URL через goto.
  • Проверить синтаксис проверяет сохранённые шаги. Сайт не открывает и не ловит строгий режим Playwright во время выполнения.
  • Предупреждение, если CSS-локатор использует подстроку *=. Предпочитайте точные локаторы.
  • У press Target необязателен. Value - строка клавиши Playwright: Enter или Control+Shift+F. Модификаторы только Shift, Control, Alt, Meta, ControlOrMeta. Подробнее: Нажатие клавиши (press).

Каталог действий ​

Колонки Target / Value: обязательно, не используется или необязательно - по autotest-actions.json. Ссылка ведёт на инструкцию действия.

action_nameГруппаTargetValueTEST_ACCOUNTИнструкция
gotoНавигацияНе используетсяНеобязательно (url)Нетgoto
clickУказательОбязательноНе используетсяНетclick
rightClickУказательОбязательноНе используетсяНетrightClick
dblclickУказательОбязательноНе используетсяНетdblclick
fillВводОбязательноОбязательно (text)Даfill
typeВводОбязательноОбязательно (text)Даtype
pressSequentiallyВводОбязательноОбязательно (text)ДаpressSequentially
pressВводНеобязательноОбязательно (key)Даpress
checkВводОбязательноНе используетсяНетcheck
uncheckВводОбязательноНе используетсяНетuncheck
selectOptionВводОбязательноОбязательно (text)ДаselectOption
clearВводОбязательноНе используетсяНетclear
selectTextВводОбязательноНе используетсяНетselectText
hoverУказательОбязательноНе используетсяНетhover
focusУказательОбязательноНе используетсяНетfocus
blurУказательОбязательноНе используетсяНетblur
scrollIntoViewIfNeededУказательОбязательноНе используетсяНетscrollIntoViewIfNeeded
waitForSelectorОжиданиеОбязательноНе используетсяНетwaitForSelector
waitForURLОжиданиеНе используетсяОбязательно (url)НетwaitForURL
waitForTimeoutОжиданиеНе используетсяОбязательно (duration_ms)НетwaitForTimeout
goBackНавигацияНе используетсяНе используетсяНетgoBack
goForwardНавигацияНе используетсяНе используетсяНетgoForward
reloadНавигацияНе используетсяНе используетсяНетreload
toBeVisibleПроверкаОбязательноНе используетсяНетtoBeVisible
toBeHiddenПроверкаОбязательноНе используетсяНетtoBeHidden
toBeEnabledПроверкаОбязательноНе используетсяНетtoBeEnabled
toBeDisabledПроверкаОбязательноНе используетсяНетtoBeDisabled
toBeCheckedПроверкаОбязательноНе используетсяНетtoBeChecked
toBeEditableПроверкаОбязательноНе используетсяНетtoBeEditable
toBeFocusedПроверкаОбязательноНе используетсяНетtoBeFocused
toBeEmptyПроверкаОбязательноНе используетсяНетtoBeEmpty
toHaveTextПроверкаОбязательноОбязательно (text)ДаtoHaveText
toContainTextПроверкаОбязательноОбязательно (text)ДаtoContainText
toHaveValueПроверкаОбязательноОбязательно (text)ДаtoHaveValue
toHaveCountПроверкаОбязательноОбязательно (count)ДаtoHaveCount
toHaveURLПроверкаНе используетсяОбязательно (url)НетtoHaveURL
toHaveTitleПроверкаНе используетсяОбязательно (title)ДаtoHaveTitle
toHaveAttributeПроверкаОбязательноОбязательно (attribute_name) + expected_valueДаtoHaveAttribute
toHaveClassПроверкаОбязательноОбязательно (class_name)ДаtoHaveClass
toHaveIdПроверкаОбязательноОбязательно (dom_id)ДаtoHaveId
toHaveCSSПроверкаОбязательноОбязательно (css_property и expected_value)ДаtoHaveCSS

Ограничения ​

  • Для goto полный URL должен указывать на подтверждённый домен команды (или поддомен).
  • Падение шага группы Проверка валит результат автотеста.

Версия 2.6.0 · Последнее изменение 2026-10-27

Страница не помогла?