Драматург с машинописным текстом, разница между locator.click() и page.click()

page.click() выполняет автоматическое ожидание, так что это не имеет значения. Я могу предложить ряд причин отдать предпочтение локаторам:

1. Строгость. page.click() по умолчанию не обеспечивает строгости, поэтому, если на странице два элемента, он без ошибки щелкнет первый, тогда как locator.click() выдаст ошибку, если есть какая-либо двусмысленность. Это позволяет избежать регрессий и помогает гарантировать, что обнаруженный вами элемент останется стабильным.
2. Последовательность и простота. Если вы всегда используете операции на основе локатора, ваш код будет единообразен для чтения. Обычно я делаю вид, что операций page.action() не существует, что приводит к созданию согласованных наборов тестов, которые в основном состоят из getByRole и нескольких других ключевых методов. У Playwright довольно обширный и сложный API, поэтому все, что вы можете сделать, чтобы запретить часть его методов, — это хорошо.
3. Разделение интересов. Разделение локаторов (то, чего вы не ждете) и действий (то, что вы ожидаете) обеспечивает возможность повторного использования локаторов и способствует написанию Объектных моделей страниц, канонического способа организации локаторов и действий по отношению к конкретной странице. посмотреть на сайте. При использовании page.click() вам придется перезаписывать строку селектора (или использовать строковую константу) при каждом вызове, что наносит ущерб возможности повторного использования. С помощью локаторов вы можете объявить локатор один раз в конструкторе POM, а затем со временем выполнять с ним множество различных действий.
4. У того, чтобы видеть page.locator(selector).action(options) снова и снова в разных формах, есть определенный ритм, не нарушаемый идиомой page.action(selector, options). Некоторые пользователи Playwright не понимают, где расположены параметры, и, возможно, не используют TypeScript, поэтому последовательное соблюдение второго шаблона может улучшить ясность.
5. API локатора — это нечто большее, чем просто page.locator(). Другими локаторами являются page.getByRole(), page.getByLabel(), page.getByText() и подобные методы, которые обеспечивают видимый пользователю выбор лучших практик. Если вы используете page.click(), вы, скорее всего, используете CSS или XPath, которые не рекомендуются. API пытается заставить вас использовать page.getByRole(), даже вместо обычного page.locator(), а также page.click(), page.$() и т. д.
6. Возможность связывания и фильтрации. Драматург предлагает использовать цепочку и фильтрацию с локаторами, но это невозможно с помощью методов page.action(). Отсутствие цепочек может привести к чрезмерному использованию CSS и XPath для устранения неоднозначности выбора.
7. Локаторы покрывают 100% функциональности нерекомендуемых подходов, поэтому единственная польза от использования page.click() — это экономия нескольких нажатий клавиш.

Вы написали

Недавно я обновляю кучу старых функций, созданных год назад или около того, и по некоторым причинам, когда меняю, например

await this.page.click('.add-card') с await this.page.locator('.add-card').click()

поведение меняется, и некоторые элементы больше не ждут; поэтому тест не пройден.

Это не имеет смысла. locator.click() определенно авто-ожидание, поэтому единственная ошибка, которую я могу себе представить, связана со строгостью (соответствие более чем одному элементу). Чтобы получить помощь, вам нужно будет поделиться минимальным, воспроизводимым примером и полной трассировкой стека или ошибкой утверждения. Распространенной ошибкой является невыполнение await действия локатора, поэтому сначала проверьте это.