Try-catch блоки

В процессе автоматизированного тестирования с использованием Puppeteer обработка ошибок является неотъемлемой частью разработки надёжных и устойчивых тестов. Одним из самых распространённых способов обработки ошибок в JavaScript является использование блока try-catch. Этот подход позволяет ловить и обрабатывать исключения, которые могут возникнуть в процессе выполнения кода.

Суть использования try-catch

Блок try-catch предназначен для того, чтобы обрабатывать ошибки, возникающие в момент исполнения программы, и предотвращать её полный сбой. В отличие от других методов, таких как простая проверка условий, try-catch помогает локализовать ошибку, не давая ей затронуть остальные части программы.

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

Структура try-catch 

try {
    // Код, который может вызвать ошибку
} catch (error) {
    // Действия при возникновении ошибки
}
  • try — содержит код, выполнение которого может привести к ошибке.
  • catch — блок, который обрабатывает ошибку, если она возникла в блоке try. В параметр error передаётся объект ошибки, который можно использовать для логирования или принятия решений.

Пример использования try-catch в Puppeteer

Для иллюстрации работы с try-catch рассмотрим типичный сценарий использования Puppeteer: автоматическое тестирование страницы на наличие ошибок при переходе по ссылкам. 

const puppeteer = require(&

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

    try {
        await page.goto('https://example.com');  // Переход на страницу
        await page.click('#non-existent-link');  // Попытка клика на несуществующий элемент
    } catch (error) {
        console.error('Произошла ошибка:', error.message);
        // Логирование ошибки или выполнение других действий
    }

    await browser.close();
}

runTest();

В данном примере блок try содержит два действия: переход по URL и попытка кликнуть на элемент, который на странице может отсутствовать. Если элемент не будет найден, возникнет ошибка, которую поймает блок catch.

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

Важно не только поймать ошибку, но и зафиксировать информацию о ней для последующего анализа. Блок catch предоставляет доступ к объекту ошибки, который содержит информацию о типе ошибки, её сообщении, стеке вызовов и других деталях. 

try {
    await page.goto('https://example.com');
    await page.click('#submit-button');
} catch (error) {
    console.error(`Ошибка при клике на кнопку: ${error.message}`);
    console.error(`Стек ошибки: ${error.stack}`);
}

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

Использование try-catch для работы с асинхронными операциями

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

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

    try {
        await page.goto('https://example.com');
        await page.waitForSelector('#main-content', { timeout: 5000 });
    } catch (error) {
        console.error('Ошибка при загрузке страницы или ожидании элемента:', error.message);
    }

    await browser.close();
}

testNavigation();

В данном случае ошибка может быть вызвана либо проблемами с загрузкой страницы, либо с отсутствием нужного элемента в течение заданного времени. Использование блока try-catch помогает избежать необработанных ошибок.

Возврат значений при возникновении ошибки

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

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

    try {
        await page.goto('https://example.com');
        await page.waitForSelector('#non-existent-element', { timeout: 5000 });
        return true;
    } catch (error) {
        console.log('Элемент не найден:', error.message);
        return false;  // Возвращаем false при ошибке
    } finally {
        await browser.close();
    }
}

checkElementPresence().then(result => {
    if (result) {
        console.log('Элемент найден!');
    } else {
        console.log('Элемент отсутствует.');
    }
});

В этом примере блок catch возвращает значение false в случае возникновения ошибки, что позволяет продолжить выполнение программы без полного её остановки.

Обработка нескольких ошибок

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

try {
    await page.goto('https://example.com');
    await page.click('#non-existent-button');
} catch (error) {
    if (error.message.includes('no such element')) {
        console.log('Не найден элемент на странице:', error.message);
    } else if (error.message.includes('timeout')) {
        console.log('Время ожидания элемента истекло:', error.message);
    } else {
        console.log('Произошла неизвестная ошибка:', error.message);
    }
}

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

Заключение

Использование блоков try-catch в Puppeteer помогает значительно улучшить стабильность и надёжность тестов. Он позволяет предотвратить падение программы при возникновении ошибок и предоставляет возможность для логирования и анализа возникающих проблем. Обработка различных типов ошибок позволяет точно локализовать проблемы и быстро находить решения для каждой ситуации.

Оглавление