Автоматическое ожидание

Введение​

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

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

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

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

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

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

Проверки​

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

Подробнее см. в руководстве по проверкам.

Видимость​

Элемент считается видимым, если его ограничивающий прямоугольник имеет ненулевой размер и у него нет вычисленного стиля visibility:hidden.

Согласно этому определению:

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

Стабильность​

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

Активность​

Элемент считается активным, если он не отключён.

Элемент считается отключённым, если:

• это <button>, <select>, <input>, <textarea>, <option> или <optgroup> с атрибутом [disabled];
• это <button>, <select>, <input>, <textarea>, <option> или <optgroup>, являющийся частью <fieldset> с атрибутом [disabled];
• это потомок элемента с атрибутом [aria-disabled=true].

Возможность редактирования​

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

Элемент считается доступным только для чтения, если:

• это <select>, <input> или <textarea> с атрибутом [readonly];
• у него есть атрибут [aria-readonly=true] и роль aria, которая поддерживает его.

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

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

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

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