核心 API 通俗详解

编写脚本时，您最常用到的就是以下几个命令。我们用通俗的语言为您解释它们的用途。

1. 页面跳转与加载

• page.goto(url)
  • 白话：让浏览器“去这个网址”。
  • 技巧：建议带上 { waitUntil: 'networkidle2' }。这表示等网页加载得差不多了（网络活动基本停止）再执行后续代码，否则可能会因为网页还没刷出来而报错。
• page.waitForNavigation()
  • 白话：等页面“跳一下”。
  • 场景：当你点击了一个登录按钮，页面会发生跳转。这时候你需要用这个命令等待跳转完成后再操作新页面。

2. 查找与等待元素

• page.waitForSelector(选择器)
  • 白话：盯着屏幕，直到“那个东西”出现。
  • 重要性：最推荐的命令！ 网页渲染有快有慢，直接点击还没刷出来的按钮会报错。养成先“等”再“点”的好习惯。
• page.$(选择器)
  • 白话：把那个元素“抓过来”。
  • 用途：抓过来之后，你可以获取它的文字、属性或者判断它是否存在。

3. 模拟人类操作

• page.type(选择器, 文字)
  • 白话：把文字“打进去”。
  • 实战：通常用于输入账号、密码或搜索词。
• page.click(选择器)
  • 白话：鼠标“点一下”。
  • 技巧：如果你想点得更像人，可以加上点击间隔：await page.click(selector, { delay: 100 })。

4. 终极杀招：脚本注入

• page.evaluate(函数)
  • 白话：在网页里“搞事情”。
  • 用途：这是最高级的命令。它可以让你直接在浏览器页面内执行 JavaScript 代码。比如网页上有一个很难点击的按钮，你可以直接用 document.querySelector('...').click() 来暴力解决。也可以用它来提取网页上的复杂数据。

5. 截图与 PDF

• page.screenshot({ path: '...' })
  • 白话：咔嚓，拍张照。
  • 用途：自动化执行过程中，拍下关键步骤存证，或者在出错时自动截图方便复盘。

---

TIP

理论掌握了？下一章 实战案例：自动登录与 Cookie 注入 带你进入真实业务场景。