Справочник элементов
Элемент
Элемент
Элемент в репозитории объектов - именованный локатор, который повторно используют шаги автотеста. Данные локатора хранятся в каталоге проекта и не повторяются в каждом шаге.
Связи
| Связанный элемент | Как связан |
|---|---|
| Проект | Обязательный владелец |
| Папка | Группирует элементы в каталоге 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.
Страница не помогла?