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

Элемент

Элемент ​

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

Карточка элемента репозитория объектов

Связи ​

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

Поля ​

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

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

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

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

Правила ​

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

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

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

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

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