Skip to content

Справочник по основным API

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

1. Навигация по страницам

Переход на указанный веб-сайт — это первый шаг автоматизации.

javascript
await page.goto('https://www.google.com');

Вы можете ждать различных стадий загрузки страницы:

  • networkidle0: Сетевые запросы полностью прекратились (не более 0 соединений в течение 500 мс).
  • networkidle2: Сетевые запросы почти прекратились (не более 2 соединений в течение 500 мс).

2. Взаимодействие с элементами

Клик (Click)

Введите CSS-селектор для имитации клика мыши.

javascript
await page.click('#login-button');

Ввод текста (Type)

Имитация клавиатуры для ввода текста.

javascript
await page.type('#username', 'my_account');

3. Механизм ожидания

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

javascript
await page.waitForSelector('.success-message');

4. Evaluation (Вызов JS на стороне браузера)

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

javascript
const title = await page.evaluate(() => {
  return document.title;
});

TIP

Теория освоена? Следующая глава Примеры из реальной жизни познакомит вас с реальными бизнес-сценариями.