Логирование ошибок

Логирование ошибок в автоматизированных тестах — неотъемлемая часть процесса, которая позволяет быстро выявлять проблемы и диагностировать неисправности. Puppeteer, являясь мощным инструментом для взаимодействия с браузером через Node.js, предоставляет разработчикам множество возможностей для ведения журналов и отслеживания ошибок, происходящих в процессе выполнения тестов.

Основы логирования

В Puppeteer основным способом для логирования ошибок является использование стандартных инструментов JavaScript, таких как console.log(), console.error(), а также возможности самого Puppeteer для получения информации о происходящих событиях в браузере. Однако для более глубокого анализа тестов и выявления потенциальных проблем следует использовать более детализированные подходы.

Использование событий для логирования

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

  1. Логирование ошибок страницы

Для отслеживания ошибок, которые происходят на странице, можно использовать событие page.on(‘console’, callback), которое позволяет получить доступ ко всем консольным сообщениям, выводимым в браузере, включая ошибки и предупреждения.

Пример кода для логирования ошибок на странице: 

const puppeteer = require(&


async function run() { const browser = await puppeteer.launch();
const page = await browser.newPage();


// Логирование сообщений консоли страницы page.on('console', (msg)
=> { if (msg.type() === 'error') { console.error('Ошибка на
странице:', msg.text()); } });


await page.goto('https://example.com');


await browser.close(); }

run();

В этом примере мы отслеживаем консольные ошибки страницы и выводим их в лог. Это полезно для диагностики проблем, которые могут возникнуть в процессе рендеринга или выполнения JavaScript на странице.

  1. Логирование сетевых ошибок

Проблемы с сетевыми запросами часто являются источником ошибок в тестах. Puppeteer позволяет перехватывать и логировать сетевые запросы с помощью события page.on(‘requestfailed’, callback).

Пример кода для логирования сетевых ошибок: 

page.on('requestfailed', (request) => {
  console.error(`Запрос не выполнен: ${request.url()} - ${request.failure().errorText}`);
});

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

  1. Логирование ошибок навигации

Ошибки, связанные с навигацией, могут происходить по разным причинам, например, если страница не может быть загружена или переход на другую страницу занимает слишком много времени. Для отслеживания таких ошибок можно использовать событие page.on(‘error’, callback) и page.on(‘pageerror’, callback).

Пример кода для логирования ошибок при навигации: 

page.on('error', (error) => { console.error('Ошибка на
странице:', error.message); });


page.on('pageerror', (error) => { console.error('Ошибка JavaScript на
странице:', error.message); });

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

Логирование ошибок при работе с элементами

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

  1. Логирование ошибок при поиске элементов

Когда вы пытаетесь найти элемент, которого нет на странице, может возникнуть ошибка. Метод page.() < /code > или < code > page.$()</code> возвращает <code>null</code>, если элемент не найден, и этот момент следует учесть при логировании.</p> <p>Пример кода для логирования ошибок при поиске элементов:</p> <pre class="javascript"><code>const element = await page.$('#non-existent-element'); if (!element) { console.error('Элемент не найден на странице'); }

  1. Логирование ошибок при взаимодействии с элементами

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

Пример кода для логирования ошибок при клике на элемент: 

const button = await page.$('.submit-button');
if (!button) {
console.error('Кнопка не найдена на странице');
} else {
try {
 await button.click();
} catch (error) {
 console.error('Не удалось кликнуть на кнопку:', error.message);
}
}

В данном примере, если кнопка не найдена на странице, будет выведено сообщение об ошибке. Если кнопка найдена, но возникнет ошибка при попытке клика, эта ошибка также будет зафиксирована.

Логирование ошибок при работе с браузером

Puppeteer также предоставляет инструменты для логирования ошибок на уровне самого браузера. Это может быть полезно для диагностики проблем с браузером или его настройками.

  1. Логирование ошибок при запуске браузера

При запуске браузера могут возникать ошибки, такие как проблемы с загрузкой браузера, неправильные пути к исполняемым файлам или конфигурационные проблемы.

Пример кода для логирования ошибок при запуске браузера: 

try {
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
} catch (error) {
console.error('Ошибка при запуске браузера:', error.message);
}

Этот подход позволяет ловить ошибки на этапе инициализации Puppeteer и быстро реагировать на них.

Ведение логов с использованием внешних библиотек

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

Пример использования библиотеки winston: 

const winston = require('winston'); const puppeteer =
require('puppeteer');




// Настройка winston для логирования const logger =
winston.createLogger({ level: 'info', transports: [ new
winston.transports.Console(), new winston.transports.File({ filename:
'logfile.log' }) ] });


async function run() { const browser = await puppeteer.launch();
const page = await browser.newPage();


page.on('console', (msg) => { if (msg.type() === 'error') {
logger.error(Ошибка на странице: ${msg.text()}); } });


await page.goto('https://example.com');


await browser.close(); }

run();

В этом примере используется библиотека winston для логирования ошибок консоли и записи их в файл.

Заключение

Логирование ошибок — ключевая часть тестирования с Puppeteer. Отслеживание консольных сообщений, сетевых ошибок, ошибок навигации и взаимодействий с элементами помогает не только в диагностике ошибок, но и в улучшении стабильности тестов. Для более сложных решений стоит использовать внешние библиотеки логирования, которые обеспечат большую гибкость и контроль над процессом.

Оглавление