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

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