В pw много разных локаторов, и кто начинает автоматизацию — не понимает, какой и когда использовать. Вот небольшая заметка-шпаргалка.

Стратегия выбора локаторов

Приоритет от лучшего к худшему:

1⃣ getByRole() - Лучший выбор
2⃣ getByLabel() - Для полей форм
3⃣ getByPlaceholder() - Если нет label
4⃣ getByText() - Для статического текста
5⃣ getByAltText() - Для изображений
6⃣ getByTitle() - Редко, но можно
7⃣getByTestId() - Для сложных случаев
8⃣ CSS/XPath - Не рекомендуется к использованию

Алгоритм выбора:

Это кнопка/ссылка/поле? ➡ getByRole()
Это поле с лейблом? ➡ getByLabel()
Это текст на странице? ➡ getByText()
Ничего не подходит? ➡ Добавить data-testid

🔗 Дока