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

Нет логов консоли Playwright? Проверьте обработчик

Разделите stdout Node, консоль браузера и неперехваченные ошибки страницы. Подключайте обработчики заранее и проверяйте ограниченную историю Playwright.

BotBrowser Team

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

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

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

При отсутствии логов консоли Playwright сначала нужно проверить, где возникло сообщение и когда подключили обработчик. Вызов console.log() в тесте Node выполняется в другой среде, чем такой же вызов на странице, а неперехваченное исключение страницы имеет отдельное событие. BotBrowser поддерживает управление своим браузером через Playwright; он не объединяет эти каналы вывода и не может доставить прошлые сообщения поздно подключённому обработчику.

Кратко

  • Подпишитесь на page.on('console') до навигации или действия, создающего сообщение браузера. Явно выводите полученное сообщение, если оно должно появиться в терминале.
  • Отдельно подпишитесь на page.on('pageerror') для неперехваченных исключений страницы. Браузерный console.error() создаёт сообщение консоли с типом error.
  • Вызов Node console.log() пишет в stdout процесса теста. Его наличие не доказывает работоспособность обработчика страницы.
  • В Playwright v1.56+ методы page.consoleMessages() и page.pageErrors() предоставляют ограниченную недавнюю историю. Чтение истории не воспроизводит события для вновь подключённого обработчика.

Содержание

Определите канал вывода до изменения теста

Слово «консоль» может означать процесс Node, выполняющий тест, инструменты разработчика браузера или объект Playwright ConsoleMessage, переданный в функцию обратного вызова. Одинаковая запись console.log() не делает эти назначения взаимозаменяемыми. Начните со строки, создающей отсутствующий текст: определите, выполняется ли она непосредственно в файле теста, внутри page.evaluate() или в скрипте приложения, загруженном страницей.

Согласно документации консоли Node, глобальная консоль отправляет обычный вывод в stdout, а вывод ошибок в stderr. Поэтому console.log('NODE_DRIVER_ONLY') непосредственно в тестовом скрипте CommonJS является выводом процесса теста. Обработчик консоли страницы его не получает. Система CI может отображать или захватывать этот поток независимо от того, что Playwright наблюдает в браузере.

Напротив, await page.evaluate(() => console.log('PAGE_LOG')) выполняет вызов логирования в браузере. Событие console объекта Page в Playwright предоставляет вызовы консольного API страницы. Чтобы переслать событие в вывод Node, добавьте обработчик, вызывающий консоль Node или записывающий выбранные поля в артефакт. Обработчик, который только добавляет данные в массив, не выводит этот массив в терминал автоматически.

Неперехваченное исключение скрипта представляет собой третий сигнал. Событие pageerror объекта Page сообщает о неперехваченных исключениях внутри страницы. Вызов console.error('PAGE_CONSOLE_ERROR') записывает сообщение уровня ошибки без выбрасывания исключения. И наоборот, скрипт может выбросить исключение без предварительного console.error(). При расследовании остановки приложения во время запуска захватывайте оба типа событий.

Это различие влияет не только на видимость, но и на результат теста. Сообщение с типом error может принадлежать намеренно проверяемому ошибочному сценарию; пустая консоль не доказывает правильное сохранение формы. Если требуется результат операции API, ожидание ответа после клика показывает, как идентифицировать запись и проверить её ответ независимо от текста статуса страницы. Логирование даёт сведения об операции, а утверждения определяют, что она должна выполнить.

Проследите маркер от строки, которая его создала. Тестовый скрипт пишет в stdout Node. Для строки со страницы выбирайте обработчик по действию скрипта: вызов консольного API или неперехваченное исключение.

Маркер Node поступает в stdout. Вызовы log и error консоли страницы поступают обработчику console. Неперехваченное исключение страницы поступает обработчику pageerror.

Подключите обработчики браузера до запускающего действия

Регистрируйте наблюдателей до page.goto(), page.setContent() или клика, выполняющего исследуемый код. Регистрация синхронна: page.on() устанавливает функцию обратного вызова и возвращается без ожидания будущего сообщения. После этого навигация может начаться с уже установленным наблюдателем. Если разместить обработчик ниже await page.goto(), стартовые сообщения окажутся вне его окна наблюдения, даже если страница затем остаётся открытой.

Следующий самостоятельный пример CommonJS использует собственную встроенную страницу и установленный пакет playwright. Он создаёт синтетические метки без подключения к внешнему приложению. Обработчик консоли печатает тип и текст сообщения; обработчик исключений использует другой префикс, чтобы потоки нельзя было перепутать. Временные Promise событий определяют конкретные сообщения, необходимые примеру, вместо ожидания фиксированной задержки.

const { chromium } = require('playwright');

(async () => {
  const browser = await chromium.launch();
  try {
    const page = await browser.newPage();

    page.on('console', message => {
      console.log(`[page console:${message.type()}] ${message.text()}`);
    });
    page.on('pageerror', error => {
      console.error(`[page uncaught] ${error.message}`);
    });

    const logSeen = page.waitForEvent('console', {
      predicate: message => message.text() === 'PAGE_LOG_STARTUP',
      timeout: 5000,
    });
    const errorSeen = page.waitForEvent('pageerror', {
      predicate: error => error.message === 'PAGE_UNCAUGHT_STARTUP',
      timeout: 5000,
    });

    console.log('NODE_DRIVER_ONLY');
    await Promise.all([
      logSeen,
      errorSeen,
      page.setContent(`<script>
        console.log('PAGE_LOG_STARTUP');
        console.error('PAGE_CONSOLE_ERROR_STARTUP');
        throw new Error('PAGE_UNCAUGHT_STARTUP');
      </script>`),
    ]);
  } finally {
    await browser.close();
  }
})().catch(error => {
  console.error(error);
  process.exitCode = 1;
});

Значение 5000 ms ограничивает ожидание в этом контролируемом примере; это не рекомендация увеличивать каждый таймаут приложения. Скрипт намеренно выбрасывает исключение в элементе script страницы. Исключение непосредственно внутри ожидаемого page.evaluate() имеет другое следствие для драйвера: вычисление отклоняется, а тест должен обработать или проверить это отклонение. Не заменяйте скрипт отклонённым вычислением, предполагая, что оно демонстрирует то же событие неперехваченного исключения страницы.

Сама функция логирования выполняется в Node. Её console.log() пересылает наблюдаемое сообщение браузера в stdout, а console.error() пересылает исключение страницы в stderr. Отчёт, объединяющий потоки, может показывать оба префикса вместе. Система, захватывающая только stdout, способна пропустить строку исключения, хотя обработчик pageerror выполнился, поэтому перед изменением браузерного кода проверьте конфигурацию вывода.

Делайте обработчики небольшими и сохраняйте их как именованные функции, если сборщик потребуется удалить. page.off('console', onConsole) удаляет именно этот сборщик; удаление всех обработчиков консоли способно нарушить фикстуры, установленные в другом месте. Повторная установка сборщика на той же странице также может печатать одно событие несколько раз. Дублированные строки терминала могут означать повторную подписку, а не повторное выполнение приложения.

Сравните раннюю и позднюю подписки на своей странице

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

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

2026-11-18 собственная фикстура завершилась с Playwright 1.58.0, стандартным Chrome 157.0.8103.79 и Node v26.9.0 на macOS arm64. Оба варианта прошли свои утверждения. Таблица учитывает только точные синтетические маркеры, а не все возможные диагностические сообщения браузера. Ожидаемое назначение определяется местом выполнения вызова; столбец наблюдений различает живые обработчики исследуемого наблюдателя и чтение сохранённой истории.

Источник сообщенияОжидаемое назначение или поведениеНаблюдение в собственной фикстуре
Драйвер Node console.log('NODE_DRIVER_ONLY')stdout Node, вне консоли страницыНапечатано в stdout; отсутствует в событиях консоли браузера в обоих вариантах
Старт страницы console.log('PAGE_LOG_STARTUP')Событие console страницы, тип logРанний наблюдатель получил; поздний пропустил в живом потоке
Старт страницы console.error('PAGE_CONSOLE_ERROR_STARTUP')Событие console страницы, тип error, без исключенияРанний наблюдатель получил; поздний пропустил в живом потоке; соответствующего pageerror нет
Старт страницы throw new Error('PAGE_UNCAUGHT_STARTUP')Событие pageerror страницыРанний наблюдатель получил; поздний пропустил в живом потоке
Та же страница создаёт PAGE_LOG_AFTER_ATTACH, PAGE_CONSOLE_ERROR_AFTER_ATTACH и PAGE_UNCAUGHT_AFTER_ATTACHИсследуемый наблюдатель получает новые сигналы после регистрацииОба наблюдателя получили два сообщения консоли и одно неперехваченное исключение страницы
История позднего варианта, прочитанная до и сразу после подключения исследуемого наблюдателяСохранённые записи могут существовать отдельно от живой доставкиОба чтения содержали два стартовых маркера консоли и одно стартовое исключение; обработчики исследуемого наблюдателя не получили повтора

Точная сводка stdout этого запуска:

NODE_DRIVER_ONLY
early: liveConsole=4 livePageErrors=2 retainedConsole=4 retainedPageErrors=2
late: liveConsole=2 livePageErrors=1 retainedConsole=4 retainedPageErrors=2

Ранние итоги включают запуск и положительный контроль. Поздние живые итоги содержат только маркеры после регистрации. При заключительном чтении обе страницы сохраняли все четыре маркера консоли и оба неперехваченных исключения. Фикстура не пересылала сообщения страницы в stdout, поэтому строка NODE_DRIVER_ONLY показывает реальный вывод драйвера, а не браузерную строку, напечатанную пересылающей функцией.

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

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

Читайте недавнюю историю без предположения о полноте

В Playwright v1.56 появились page.consoleMessages() и page.pageErrors(). Текущая документация API описывает каждый метод как возвращающий до 200 последних записей соответствующей страницы. Эти методы позволяют прочитать диагностику позднее, но ограниченная коллекция отличается и от живого обработчика, и от долговечного файла журнала.

Читайте обе коллекции, пока соответствующий Page ещё доступен, и помечайте вывод как историю. Фрагмент предполагает, что приложение уже достигло состояния, в котором интересующие сообщения должны были появиться. Он намеренно использует формы без аргументов, доступные в v1.56, вместо более новых параметров из последней документации.

const recentConsole = await page.consoleMessages();
const recentErrors = await page.pageErrors();

for (const message of recentConsole) {
  console.log(`[history console:${message.type()}] ${message.text()}`);
}
for (const error of recentErrors) {
  console.error(`[history uncaught] ${error.message}`);
}

Эти два чтения дают снимки, полученные отдельными вызовами, а не одну атомарную запись всего браузера. Между ними возможна новая активность. Чтение коллекции также не создаёт условия ожидания конкретного будущего события. Если тест должен дождаться известного нового сообщения, зарегистрируйте page.waitForEvent('console', { predicate }) до запускающего действия и ограничьте ожидание, как в предыдущем примере.

У отсутствующей записи истории есть несколько возможных объяснений: вызов не выполнился, относится к другой странице или находится за пределами сохранённой коллекции. Шумная страница способна вытеснить старое сообщение за документированный предел. Контролируемая стартовая фикстура использует лишь несколько точных меток; она не проверяет хранение при непрерывном логировании и не устанавливает возможность восстановления каждого исторического сообщения.

Проверьте версию пакета, используемую процессом, который действительно выполняет тест. Запустите npm ls playwright playwright-core @playwright/test в этом проекте, затем сопоставьте разрешённые пакеты с импортами и файлом блокировки зависимостей. Глобально доступный CLI может отличаться версией от локально импортируемой библиотеки. Старый пакет способен правильно поддерживать живые события, но не иметь новых методов истории; изменение флагов браузера не добавляет отсутствующий метод библиотеки Node.

Если старая установка Playwright должна остаться закреплённой, используйте ранний живой сборщик как практический запасной вариант. Храните только необходимые для диагноза поля и задайте явный предел хранения, подходящий тесту. Не называйте локальный массив полной историей браузера: он охватывает окно подписки сборщика и события, принятые его фильтрами. API истории полезны для проверки, а намеренно ранний сбор даёт тесту контроль над жизненным циклом собственных диагностических данных.

Различайте тип сообщения, аргументы и место вызова

API ConsoleMessage предоставляет text(), type(), args() и location(). Начните с типа и текста: это простые синхронные значения. При первичной диагностике захватывайте все типы, а не фильтруйте только error. Обычный console.log() страницы создаёт сообщение log и исчезнет из сборщика только ошибок даже при идеально выбранном времени подписки.

Используйте имена типов, возвращаемые Playwright, а не угадывайте их по названию браузерного метода. Например, документированный тип для console.warn() называется warning. Фильтр по строке warn незаметно исключает его. Добавляйте к пересылаемым строкам источник и тип, чтобы собственная диагностика теста оставалась отличимой от получаемых им сообщений страницы.

text() даёт строковое представление, а не обещание сохранения каждого объекта в JSON. Если собственное приложение пишет console.log('save', { revision: 7 }), используйте args(), когда важны значения отдельных аргументов. Эти аргументы являются объектами JSHandle, и чтение сериализуемых значений требует ожидания jsonValue() каждого объекта. Элементы DOM, циклические структуры и объекты с особым поведением требуют большей осторожности, чем простая запись ревизии.

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

location() помогает отличить сборку приложения от внедрённого тестового скрипта. URL ресурса и исходные координаты с отсчётом от нуля обозначают место вызова консоли, сообщаемое Playwright, но не обязательно исходную авторскую строку до сборки. Не добавляйте единицу к координатам, уже преобразованным для человека в другой части системы отчётности. Пустые или синтетические позиции должны оставаться помеченными как таковые, без выдуманного имени файла приложения.

Ограничивайте сохраняемые данные диагностическим вопросом. Логи браузера и сериализованные аргументы могут содержать токены сессии, персональные данные или полные ответы API; URL исходников могут содержать строки запросов. Метками фикстуры PAGE_LOG_STARTUP безопасно делиться, поскольку они синтетические. Для реального отчёта выбирайте безвредные идентификаторы операций и удаляйте чувствительные значения до пересылки stdout или добавления артефактов в общую задачу.

Диагностируйте молчащий обработчик без сокрытия ошибок

Сначала отправьте одно безвредное сообщение из того самого объекта страницы, которому принадлежит сборщик. Создайте Promise waitForEvent('console') с точным синтетическим предикатом до page.evaluate(() => console.log('OWNED_DIAGNOSTIC_MARKER')), затем дождитесь обеих операций. Если событие приходит, текущий путь от страницы к драйверу работает для этого сообщения. Это не доказывает, что приложение создало более ранний стартовый лог или что всплывающее окно использует тот же объект страницы.

Затем проверьте идентичность страницы. Всплывающее окно или отдельно созданная вкладка является другим объектом Page; нельзя предполагать, что обработчик исходной страницы описывает выполнение новой вкладки. Регистрируйте нужного наблюдателя при обработке создания страниц в тесте и помечайте записи идентификатором страницы. Обработчик страницы может получать вызовы консоли её фреймов, поэтому URL дочернего фрейма в location() сам по себе не доказывает неправильную подписку.

Затем временно уберите диагностические фильтры и сопоставьте console с pageerror. Ожидаемый console.error() в первом и выброшенное исключение во втором требуют разных утверждений. Не делайте каждую строку уровня ошибки основанием для провала всего набора, если это явно не предусмотрено контрактом приложения. Также не подавляйте все исключения ради прохождения проверки вывода: неожиданные стартовые исключения могут объяснить, почему нужное действие не выполнилось.

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

Наконец, сохраняйте утверждения приложения. Получение лога save complete означает выполнение этого вызова логирования; оно не доказывает фиксацию данных сервером или появление нужного DOM. Сохраняйте проверки API и интерфейса, определяющие успех, и используйте консольные данные для объяснения их сбоев. Так проблема отсутствующего лога не превратится в тест, проходящий по оптимистичному сообщению.

Документация интеграции BotBrowser с Playwright описывает запуск его исполняемого файла через Playwright с конфигурацией на основе профиля. Такая настройка браузера отделена от выбора момента регистрации сборщика консоли, назначения пересылки и утверждений. Сравнение собственной встроенной страницы изолирует решения об обработке событий; оно не устанавливает поведение профиля, удалённого сервиса или рабочего приложения.

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

Начнёт ли console.log браузера появляться в stdout Node в оконном режиме?

Открытие видимого браузера не добавляет пересылающий обработчик в скрипт Node. DevTools и процесс теста остаются отдельными назначениями. Сохраняйте одинаковый наблюдатель page.on('console') в оконных и безоконных тестах, а если поведение приложения различается, сопоставляйте точное сообщение и идентичность страницы.

Приводит ли console.error к автоматическому провалу теста Playwright?

Событие консоли страницы предоставляет данные тесту, а сам console.error() не выбрасывает исключение. Задайте утверждение или правило отказа сборщика, если выбранные сообщения ошибок должны приводить к провалу. Прямое исключение Node или отклонённая ожидаемая операция следуют собственной обработке ошибок процесса теста и требуют отдельной диагностики.

Может ли блок catch предотвратить появление pageerror?

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

Может ли недавняя история заменить артефакты логирования в CI?

Методы истории возвращают ограниченные записи страницы при запросе; они не настраивают хранение CI и не предоставляют неограниченное хранилище. Читайте нужные записи до завершения фикстуры и прикладывайте выбранный вывод через механизм артефактов процесса теста. Указывайте фактически разрешённую версию Playwright, чтобы доступность API истории была воспроизводимой.

Источники

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

Если логи консоли Playwright отсутствуют, определите среду вызова, подключите подходящего наблюдателя страницы до выполнения и явно пересылайте или сохраняйте полученные сообщения. Чтение недавней истории в v1.56+ используйте как ограниченные диагностические снимки. Начните с одного синтетического сообщения на собственной странице, затем проверьте исходное запускающее действие приложения, сохраняя его утверждения об ответе и интерфейсе.

#Playwright#Логи Консоли#Pageerror#Отладка Тестов

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

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

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