Назад в Центр знаний
Начало работы

Playwright: ожидание ответа после клика без гонки

Исправьте тайм-аут после Save: зарегистрируйте ожидание до клика, найдите нужный POST, проверьте HTTP-статус и результат в интерфейсе.

BotBrowser Team

Документация

Нужна структурированная документация по теме Начало работы?

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

Ожидание ответа в Playwright после клика по Save может завершиться тайм-аутом, даже если страница показывает сообщение об успехе. Создайте Promise ответа до клика, определите нужный запрос, затем отдельно проверьте его статус и результат в интерфейсе. BotBrowser может запускать управляемый Playwright браузер с явно заданным профилем; он не воспроизводит событие ответа, на которое тест подписался слишком поздно, и не определяет, какой запрос приложения означает Save.

TL;DR

  • Вызовите page.waitForResponse() без await перед действием. Дождитесь сохранённого Promise после клика.
  • Сначала определите запрос: /api/save вместе с POST отличает запись от предшествующего GET по тому же пути.
  • Проверяйте response.status() отдельно. Фильтр только по 201 может превратить реальный ответ 503 в тайм-аут.
  • Проверяйте тело ответа и результат в role=status независимо. Одно сообщение об успехе не доказывает долговременное сохранение данных.

Содержание

Три разных сигнала в последовательности Save

Предположим, в подконтрольном вам редакторе ревизий обработчик Save сначала читает текущую ревизию, а затем отправляет новое значение. Оба запроса используют /api/save. Чтение GET /api/save возвращает HTTP 200 и ревизию 6; запись POST /api/save возвращает HTTP 201 и ревизию 7. Только после чтения ответа на запись обработчик устанавливает текст элемента статуса в Saved revision 7.

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

Документация Playwright по сети показывает создание Promise ответа до запускающего запрос клика, без await в первой строке. Это подписка на событие, а не поиск в истории завершённых сетевых операций браузера. Подходящий ответ, пришедший до подписки, не удовлетворит новое ожидание. Напротив, ответ после подписки может подойти независимо от того, нажимал ли тест кнопку раньше.

Временная диаграмма разделяет раннюю подписку на POST и подписку после финальной проверки интерфейса. Подписи описывают последовательность подконтрольного примера; 400 ms обозначает настроенный тайм-аут, а не измеренную длительность сети. Ранняя подписка игнорирует GET; для поздней подписки уже не остаётся POST, который можно наблюдать.

Раннее ожидание по пути и методу POST запускается до Save, игнорирует GET 200 и получает POST 201. Позднее ожидание начинается после Saved revision 7 и завершается TimeoutError: событие ответа уже произошло.

Для этого различия приложению не нужен перехват запросов. Достаточно небольшого HTTP-сервера и обработчика с обычным fetch(). Руководство по подмене сетевых ответов в подконтрольных тестах описывает замену зависимости управляемыми ответами; здесь важны момент подписки теста и выбираемый им ответ. Последовательный обработчик позволяет воспроизвести неверное первое совпадение без зависимости от скорости сети.

Настоящий редактор также может отправлять аналитику, предварительные запросы или фоновое обновление. Их наличие не меняет смысл успешного сохранения. Определяйте его по контракту подконтрольного API, а не по запросу, который случайно завершился рядом с кликом. В примере ниже успешная запись обязана вернуть 201, содержать { revision: 7 } и вызвать соответствующий текст статуса.

Воспроизведение действительно поздней подписки

Для минимального сбоя ответ должен завершиться до подписки. Простое размещение waitForResponse() строкой ниже await button.click() не гарантирует этот порядок: сетевая операция может ещё выполняться, когда клик завершится. В таком коде есть гонка, но отдельный запуск способен пройти. Детерминированный пример сначала ждёт финального статуса: подконтрольная страница отображает его только после чтения тела ответа POST.

При наличии page из Playwright и модуля утверждений Node следующий заведомо поздний вариант делает порядок явным. Он предполагает заново загруженную подконтрольную форму, одну кнопку с уникальным именем Save, один элемент статуса и отсутствие автоматического повторного POST. Тайм-аут 400 ms ограничивает отрицательную проверку; это не рекомендуемая длительность ожидания в рабочем тесте.

const assert = require('node:assert/strict');

const savePost = response => new URL(response.url()).pathname === '/api/save' && response.request().method() === 'POST';

await page.getByRole('button', { name: 'Save', exact: true }).click();
await page
  .getByRole('status')
  .filter({ hasText: /^Saved revision 7$/ })
  .waitFor();

await assert.rejects(page.waitForResponse(savePost, { timeout: 400 }), error => error.name === 'TimeoutError');

Отрицательное утверждение уместно только в этом примере сбоя. Тест приложения должен завершаться ошибкой, если обязательный ответ отсутствует, а не принимать любой тайм-аут. Имя исключения проверяется, чтобы закрытая страница, некорректный предикат или другая ошибка программирования случайно не были приняты за ожидаемый отрицательный результат.

Ключевую предпосылку задаёт обработчик страницы. Он выполняет await fetch('/api/save'), читает полученный JSON, выполняет POST, читает его JSON и затем отображает ревизию. Если другое приложение оптимистично показывает успех до завершения запроса, ожидание сообщения не устанавливает такой же порядок. Прежде чем использовать состояние интерфейса как доказательство уже произошедшего ответа, изучите реальный обработчик или сопоставьте его trace.

После обновления эта форма не выполняет опрос или повторные попытки. В приложении с фоновыми POST позднее ожидание может получить ответ следующей операции вместо тайм-аута. Но и это не доказывает наблюдение исходного сохранения. При необходимости задайте прикладную идентичность параллельных или повторных записей и сбрасывайте состояние между заведомо ошибочным и исправленным вариантами, чтобы событие одного запуска не удовлетворило другой.

Вывод из отрицательного случая узкий: завершённое событие ответа не воспроизводится для нового ожидания. Он не устанавливает, что каждое ожидание ответа сразу после любого клика завершится неудачей. Медленный сервер может месяцами создавать впечатление надёжности небезопасного порядка; быстрый локальный сервер способен обнаружить ту же гонку без изменения браузера.

Подписка до клика и проверка POST

Исправление переносит подписку перед действием и сохраняет её Promise. Для подконтрольной страницы с уже загруженной формой следующий шаблон подходит для самостоятельного скрипта Playwright. Он использует утверждения Node; проект Playwright Test может применять собственный expect для значений ответа и автоматически повторяемые проверки DOM. Если сам Save соответствует нескольким элементам, сначала устраните strict mode violation локатора, прежде чем объяснять отсутствующий POST временем ожидания ответа.

const assert = require('node:assert/strict');

const responsePromise = page.waitForResponse(
  response => new URL(response.url()).pathname === '/api/save' && response.request().method() === 'POST'
);

const [, response] = await Promise.all([
  page.getByRole('button', { name: 'Save', exact: true }).click(),
  responsePromise,
]);

assert.equal(response.status(), 201);
assert.deepEqual(await response.json(), { revision: 7 });
await page
  .getByRole('status')
  .filter({ hasText: /^Saved revision 7$/ })
  .waitFor();
assert.equal(await page.getByRole('status').innerText(), 'Saved revision 7');

Вызов waitForResponse() создаёт подписку немедленно. Сохранение Promise не блокирует следующий клик. Затем Promise.all() наблюдает обе операции вместе, сохраняя отдельные пути ошибки клика и ожидания ответа. Не пишите await page.waitForResponse(...) до запуска клика: это остановит тест перед действием, которое должно породить ответ.

Справочник Response API определяет url(), request(), status() и json(). Предикат использует разобранный pathname URL ответа, исключая случайные совпадения по подстроке вроде /api/save-preview. Он проверяет метод исходного запроса, потому что чтение и запись используют одну конечную точку. Затем проверка статуса отвечает на другой вопрос: вернула ли конкретная запись код успеха, предусмотренный контрактом примера?

Если страница обращается к нескольким источникам с одинаковым путём, также сравните new URL(response.url()).origin с ожидаемым источником API. Сохраняйте значимые параметры запроса, если они определяют операцию: разбор одного pathname намеренно их игнорирует. Пример предполагает один подконтрольный источник и одну запись на клик, поэтому дополнительные правила идентификации здесь ничего не различат.

Если приложение способно одновременно отправлять несколько POST на /api/save, пути и метода недостаточно. Различить их могут идентификатор подконтрольной записи, поле тела запроса или выданный приложением идентификатор операции. Проверяйте ожидаемое поле вместо записи целых тел в журнал: они могут содержать пользовательские данные. Даже при точной идентификации запроса серверный результат может быть неуспешным; разделяйте эти решения.

Проверка DOM следует за проверкой тела: обновление интерфейса не совпадает с доступностью ответа. Ожидание ответа не означает, что обработчик Promise в приложении уже отобразил результат. Поэтому возможен короткий промежуток, когда POST доступен тесту, а статус ещё равен Saving. Ожидание конкретного результата обрабатывает переход без паузы произвольной длительности.

Минимальный контракт подконтрольного сервера

Для воспроизведения подойдёт любой HTTP-сервер на loopback, который отдаёт следующую форму и возвращает JSON для двух методов. Настройте GET /api/save на 200 с { "revision": 6 }, а POST /api/save на 201 с { "revision": 7 }. POST принимает { "revision": 7 }; для демонстрации выбора ответа сохранять данные не обязательно. Загружайте форму заново перед каждым вариантом теста.

<form>
  <label>Revision <input name="revision" type="number" value="7" /></label>
  <button type="submit">Save</button>
</form>
<p role="status">Not saved</p>
<script>
  document.querySelector('form').addEventListener('submit', async event => {
    event.preventDefault();
    const status = document.querySelector('[role="status"]');
    status.textContent = 'Saving';
    try {
      const current = await fetch('/api/save');
      if (!current.ok) throw new Error('Read failed');
      await current.json();
      const response = await fetch('/api/save', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          revision: Number(document.querySelector('input').value),
        }),
      });
      if (!response.ok) throw new Error('Save failed');
      const saved = await response.json();
      status.textContent = 'Saved revision ' + saved.revision;
    } catch {
      status.textContent = 'Save failed';
    }
  });
</script>

Отдавайте форму по HTTP, а не открывайте локальным файлом: относительным URL fetch нужен источник сервера. Это оригинальный демонстрационный обработчик, а не реализация рабочей формы. Он намеренно показывает порядок чтения и записи; валидация, авторизация, хранение и обработка повторных отправок относятся к контракту настоящего приложения.

2026-11-18 подконтрольный пример на loopback выполнили с Playwright 1.58.0 и стандартным Chrome 157.0.8103.79 на macOS arm64. Все три варианта прошли свои проверки. Намеренно поздняя подписка вызвала TimeoutError при настроенном лимите 400 ms. При ранних подписках ожидание только по пути выбрало GET 200, а ожидание с учётом метода выбрало POST 201, и интерфейс достиг Saved revision 7. В ошибочном варианте ожидание с учётом метода выбрало POST 503, а интерфейс достиг Save failed. Это локальные результаты выбора событий, а не измерения долговечности хранения в рабочей среде или возможностей BotBrowser.

Фильтр только по пути выбирает неверный первый ответ

Подписка может начаться вовремя и всё равно наблюдать другую операцию. В последовательном обработчике Save следующий предикат срабатывает на GET /api/save со статусом 200, потому что это первый подходящий ответ. Более долгое последующее ожидание того же Promise не превратит выбранный ответ в следующий POST.

const responsePromise = page.waitForResponse(response => new URL(response.url()).pathname === '/api/save');
const [, response] = await Promise.all([
  page.getByRole('button', { name: 'Save', exact: true }).click(),
  responsePromise,
]);
console.log(response.request().method(), response.status());

В этом примере GET 200 является допустимым ответом на чтение, а не случайной ошибкой браузера. Проверка одного response.ok() примет его: и 200, и 201 являются успешными HTTP-кодами. Такое утверждение докажет успех выбранного GET, ничего не сообщая о последующей записи. Исправление требует более точного предиката запроса, а не большего тайм-аута.

Аналогично, подстрока конечной точки вместе с status() === 200 может прямо вводить в заблуждение, если контракт записи требует 201. Предикат должен выражать нужную тесту операцию, а не статус, знакомый по инструментам разработчика. При диагностике неверного совпадения записывайте вместе путь, метод и статус: один URL скрывает конкретное различие этого примера.

Перенаправление тоже может породить несколько связанных с действием ответов. Сопоставляйте нужную операцию API и её документированный статус, не считая адрес перенаправления взаимозаменяемым с записью. Если продукт намеренно меняет контракт API, обновляйте вместе проверки идентичности и результата. Не принимайте молча любой код 2xx, если контракт действительно не разрешает эти варианты.

Сохранение видимости HTTP-ошибок

Для диагностики сначала определите POST, затем проверяйте успех. Если сервер возвращает для записи 503, ожидание по пути и методу может завершиться, а assert.equal(response.status(), 201) сообщит о неожиданном коде. Запрос наблюдался; операция приложения не выполнила контракт успеха. Ответ с HTTP-ошибкой отличается от ответа, которого подписка вообще не получила.

Этот вариант ждёт только успешный ответ:

const successPromise = page.waitForResponse(
  response =>
    new URL(response.url()).pathname === '/api/save' &&
    response.request().method() === 'POST' &&
    response.status() === 201
);

Такой фильтр может быть уместен, если требование действительно состоит в ожидании будущего 201 среди нескольких известных попыток. Однако он меняет диагностический результат. 503 не удовлетворяет предикату; если подходящий ответ не последует, Promise завершится тайм-аутом. Тогда тайм-аут означает отсутствие ответа, соответствующего всем условиям, а не обязательно отсутствие POST или позднее начало подписки.

Сохраняйте доступ к ошибочному статусу ответа до интерпретации тела. HTML-документ ошибки может вызвать сбой response.json(), скрыв более полезную HTTP-ошибку за исключением разбора. В основном исправлении статус проверяется первым. Если нужны дополнительные детали, оставляйте небольшую очищенную диагностическую запись, а не выгружайте произвольные страницы сервера или тела аутентифицированных ответов в журналы тестов.

Собственный обработчик fetch страницы также проверяет response.ok, поэтому при неуспешном коде POST интерфейс переходит в Save failed. Уже обнаружив неудачную запись, тест не должен бесконечно ждать Saved revision 7. Проверка ошибочного сценария может намеренно подтвердить ошибочный ответ и сообщение о сбое; проверка успешного сценария должна завершиться на неожиданном статусе.

Транспортные сбои требуют другого наблюдения: ошибка соединения может вообще не создать HTTP-ответ для проверки. Playwright предоставляет события запросов для такой диагностики. Увеличенный тайм-аут ответа не создаст HTTP-статус у соединения, которое его не получило. При анализе неудачного запуска разделяйте обработку HTTP-ошибок, сетевые сбои и время выбора ответа.

Диагностика отсутствующего сигнала

Начните с минимального наблюдения, различающего причины. Подтвердите регистрацию ожидания до действия, затем проверьте реально выбранный ответ. У теста, выбравшего GET 200, другой дефект, чем у теста с POST 503, даже если оба впоследствии провалят проверку Save. Следующие решения относятся к контракту этой подконтрольной формы.

НаблюдениеЧто оно устанавливаетСледующая проверка
После итогового интерфейса новое ожидание POST завершается тайм-аутомЭто ожидание не наблюдало завершённую записьПеренесите подписку до клика
Ожидание только по пути возвращает GET 200Выбрано первое подходящее чтениеДобавьте идентификацию метода запроса
Ожидание POST возвращает 503Нужная запись получила неуспешный ответИзучите сбой подконтрольной конечной точки
POST возвращает 201, интерфейс остаётся в SavingУспех ответа не доказал завершение отображенияПроверьте обработку тела и переход интерфейса
Интерфейс показывает Saved revision 7Это состояние DOM было отображеноОтдельно проверьте ответ и требуемую долговечность хранения

Если сбой зависит от времени настоящего приложения, используйте процесс диагностики с Playwright trace. Сопоставьте действия, сетевые записи и отображённые состояния одного неудачного запуска. Trace может показать, что ответ предшествовал последующим действиям теста; новый успешный запуск не восстановит ответ, выбранный прежним ожиданием. Если одного trace недостаточно для установления выбора, добавьте узкую диагностику предиката. Если также отсутствует лог страницы, проверьте регистрацию обработчика console до навигации и отличайте эти события от вывода скрипта Node.

Не вставляйте waitForTimeout() между кликом и ожиданием ответа. Это увеличивает вероятность пропустить быстрый ответ, не задавая идентичность операции. Ожидание общего затишья в сети также отвечает не на вопрос о наблюдении одного определённого POST. Страница может сохранять посторонние соединения после завершения Save или стать сетево неактивной, пока обработчик приложения ещё работает.

Интеграция BotBrowser с Playwright описывает управление его исполняемым файлом через Playwright и применение профиля для окружения браузера. Это позволяет сравнивать браузеры в контролируемых условиях после точного определения теста приложения. Интеграция не исправляет порядок подписки, не выбирает правильный POST, не обеспечивает серверное хранение и не гарантирует принятие записи конечной точкой. Локальный HTTP-пример касается обработки событий Playwright, а не измерения возможностей BotBrowser.

Наконец, отличайте подтверждение от долговечного хранения. Этот пример возвращает ревизию 7 без базы данных, поэтому даже корректный 201 вместе с итоговым интерфейсом не доказывает сохранность после перезапуска или в другой сессии. Если бизнес-требование включает долговечность, после записи добавьте независимое повторное чтение, подходящее подконтрольному сервису. Явно определите его требования к согласованности и авторизации, не подменяя проверку повторным чтением того же оптимистично обновлённого DOM.

Вопросы и ответы

Включает ли автоматическое ожидание клика ответ Save API?

Проверки возможности клика определяют, способен ли Playwright выполнить действие над целью. Они не распознают произвольный ответ API приложения и не проверяют его JSON-схему. Зарегистрируйте отдельное ожидание ответа для нужной операции и сохраните рядом проверку видимого результата.

Стоит ли использовать response.ok() вместо точного статуса в предикате?

ok() принимает статусы от 200 до 299. Применяйте его, когда весь диапазон допустим для операции. Если контракт требует 201, точное равенство обнаружит неожиданный 200 или 202, который широкая проверка успеха пропустила бы. Без идентификации запроса ни один вариант не отличает GET от POST.

Почему ожидание ответа может завершиться до изменения интерфейса?

Событие ответа и процесс отображения приложения относятся к разным этапам. Чтение тела, прикладная валидация и обновление DOM могут продолжаться после того, как ответ стал наблюдаемым. response.json() проверяет возвращённые данные; отдельное утверждение локатора проверяет итоговый элемент статуса. Они не заменяют друг друга.

Источники

Практический вывод

Чтобы дождаться ответа в Playwright после клика по Save, сначала зарегистрируйте ожидание, найдите нужную запись и проверьте HTTP-результат перед интерфейсом. Попробуйте поздний и ранний варианты на подконтрольной последовательной форме: первый намеренно пропускает завершённое событие, второй сохраняет POST. Добавляйте отдельное повторное чтение сервиса только при требовании долговечного хранения.

#Playwright#waitForResponse#сеть#Test Debugging

Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.