Автоожидание

Введение​

Playwright выполняет ряд проверок возможности выполнения действий над элементами перед выполнением этих действий, чтобы гарантировать, что эти действия ведут себя ожидаемым образом. Он автоматически ожидает, пока все необходимые проверки пройдут, и только после этого выполняет запрошенное действие. Если необходимые проверки не пройдут в течение заданного timeout, действие завершается с ошибкой TimeoutError.

Например, для locator.click(), Playwright убедится в том, что:

• locator разрешается ровно в один элемент
• элемент Видимый
• элемент Стабильный, то есть не анимируется или анимация завершена
• элемент получает события, то есть не скрыт другими элементами
• элемент Активный

Вот полный список проверок возможности выполнения действий, выполняемых для каждого действия:

Принудительное выполнение действий​

Некоторые действия, такие как locator.click(), поддерживают опцию force, которая отключает неотложные проверки выполнимости. Например, передача истинного значения force методу locator.click() не будет проверять, действительно ли целевой элемент получает события клика.

Ассерции​

Playwright включает автоматические повторные проверки, которые устраняют нестабильность, ожидая, пока условие не будет выполнено, аналогично автоматическому ожиданию перед действиями.

Дополнительную информацию см. в руководстве по утверждениям.

Видимый​

Элемент считается видимым, если у него есть непустая область и нет visibility:hidden вычисленного стиля.

Обратите внимание, что согласно этому определению:

• Элементы нулевого размера не считаются видимыми.
• Элементы с display:none не считаются видимыми.
• Элементы с opacity:0 считаются видимыми.

Стабильный​

Элемент считается стабильным, если он сохранил ту же область размещения по меньшей мере в течение двух последовательных кадров анимации.

Включённый​

Элемент считается включённым, если он не является <button>, <select>, <input> или <textarea> со свойством disabled.

Редактируемый​

Элемент считается редактируемым, если он включен и не имеет свойства readonly.

Получает события​

Элемент считается получающим события указателя, если он является целевым элементом события указателя в точке действия. Например, при нажатии на точку (10;10), Playwright проверяет, не захватит ли какое-либо другое элемент (обычно наложение) нажатие в (10;10).

Например, рассмотрим сценарий, в котором Playwright нажмет Sign Up кнопку независимо от того, когда был выполнен вызов locator.click():

• страница проверяет, уникален ли имя пользователя, и Sign Up кнопка отключена;
• после проверки с сервером отключенная Sign Up кнопка заменяется другой, которая теперь включена.