핵심 API 레퍼런스

Puppeteer의 강력함은 코드를 통해 실제 사람의 모든 행동을 시뮬레이션할 수 있다는 점에 있습니다. 이 장에서는 페이지 조작을 빠르게 마스터할 수 있도록 가장 자주 사용되는 몇 가지 API에 대해 설명합니다.

1. 페이지 탐색 (Page Navigation)

특정 웹사이트로 이동하는 것은 자동화의 첫 번째 단계입니다.

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

페이지 로딩의 다양한 단계가 완료될 때까지 기다릴 수 있습니다:

• networkidle0: 네트워크 요청이 완전히 중단됨 (500ms 동안 연결이 0개 이하).
• networkidle2: 네트워크 요청이 거의 중단됨 (500ms 동안 연결이 2개 이하).

2. 요소 상호작용 (Element Interaction)

클릭 (Click)

CSS 선택자를 입력하여 마우스 클릭을 시뮬레이션합니다.

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

입력 (Type)

키보드를 시뮬레이션하여 텍스트를 입력합니다.

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

3. 대기 메커니즘 (Waiting Mechanism)

웹 페이지는 종종 데이터를 동적으로 로드하므로, 요소를 조작하기 전에 해당 요소가 나타날 때까지 기다려야 합니다.

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

4. 평가 (브라우저 측 JS 호출)

때로는 정보를 얻기 위해 브라우저 창 내에서 직접 코드를 실행해야 할 때가 있습니다.

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

---

TIP

이론을 마스터하셨나요? 다음 장 실전 사례에서는 실제 비즈니스 시나리오를 다룹니다.