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

Элемент

Элемент

Элемент в репозитории объектов - именованный локатор, который повторно используют шаги автотеста. Данные локатора хранятся в каталоге проекта и не повторяются в каждом шаге.

Связи

Связанный элементКак связан
ПроектОбязательный владелец
ПапкаГруппирует элементы в каталоге ELEMENT
СтраницаЭкран, на котором используется локатор
Шаг автотестаНеобязательная цель из каталога для действия с локатором
ТегНеобязательные обозначения на карточке и в списке

Поля

ПодписьСодержимоеПравило
ИмяПонятное человеку имя элементаИспользуйте имя, которое определяет элемент управления на его странице
Вид локатораСтратегия поискаДолжна соответствовать сохранённому значению локатора
Значение локатораЗначение для поиска узлаПредпочитайте значение, которое соответствует одному узлу
Доступное имяДоступное имя PlaywrightОбязательно для вида локатора ROLE

Опубликованный источник не задаёт внешние технические имена этих полей. На странице используются только проверенные подписи интерфейса.

Ключи локатора

Исполнитель принимает selector, css, id, name, placeholder, label, testid, role, accessible_name и text. Если заполнено несколько ключей, используется первый из них.

Правила

  • Страницы и элементы используют отдельные каталоги. Папка имеет вид PAGE или ELEMENT и не может смешивать оба вида.
  • Папки создаются в дереве раздела Элементы. Элемент может лежать в папке или быть без папки.
  • В корне дерева таблица показывает все элементы проекта. Откройте папку, чтобы увидеть только элементы этой папки.
  • Перетащите элемент из таблицы на папку в дереве, в том числе на пустую. После переноса элемент остаётся видимым внутри папки.
  • Выберите элемент каталога как Цель для действий click, fill, toBeVisible, toHaveAttribute и подобных.
  • Во время запуска исполнитель преобразует элемент каталога в тот же локатор, который принимает встроенная Цель.
  • Используйте accessible_name вместе с role.
  • Предпочитайте точные уникальные локаторы.

Ограничения

  • Команда Проверить синтаксис проверяет структуру сохранённого локатора, но не открывает сайт.
  • Строгий режим Playwright завершает запуск с ошибкой, если локатор соответствует нескольким узлам.
  • Селектор CSS с *= ищет подстроку. Например, ссылка с окончанием /4 может также совпасть с /42.
  • Ссылки, которые открывают новую вкладку, следует проверять на видимость или открывать через goto с полным URL.

Версия 1.2.0 · Последнее изменение 2026-09-11

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