Chromeless项目API详解：无头浏览器自动化操作指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00643/article/details/148392171

Chromeless项目API详解：无头浏览器自动化操作指南

chromeless 🖥 Chrome automation made simple. Runs locally or headless on AWS Lambda. 项目地址: https://gitcode.com/gh_mirrors/chr/chromeless

概述

Chromeless是一个基于Chrome DevTools Protocol的无头浏览器自动化工具，它提供了一套简洁的API，让开发者能够以编程方式控制Chrome浏览器完成各种操作。本文将全面解析Chromeless的API功能和使用方法。

初始化配置

创建Chromeless实例时，可以通过配置对象进行个性化设置：

const chromeless = new Chromeless({
  debug: false,       // 是否显示调试信息
  remote: false,      // 是否使用远程Chrome进程
  implicitWait: true, // 执行命令前是否等待元素存在
  waitTimeout: 10000, // 等待元素出现的超时时间(毫秒)
  viewport: {         // 视口设置
    width: 1440,
    height: 900,
    scale: 1
  },
  cdp: {              // Chrome调试协议配置
    host: 'localhost',
    port: 9222,
    secure: false,
    closeTab: true
  }
})

核心API功能分类

1. 页面导航控制

goto(url, timeout): 导航到指定URL

await chromeless.goto('https://example.com')

setUserAgent(useragent): 设置用户代理

await chromeless.setUserAgent('My Custom Agent')

2. 页面交互操作

click(selector, x, y): 点击元素

await chromeless.click('#submit-btn', 10, 10)

type(input, selector): 输入文本

await chromeless.type('搜索内容', 'input[name="q"]')

press(keyCode): 模拟按键

await chromeless.press(13) // 回车键

scrollTo(x, y): 滚动页面
```
await chromeless.scrollTo(0, 500)
```

3. 页面等待机制

wait(timeout): 固定时间等待

await chromeless.wait(2000) // 等待2秒

wait(selector, timeout): 等待元素出现

await chromeless.wait('#loading', 5000) // 最多等待5秒

4. 页面内容获取

html(): 获取完整HTML

const pageHTML = await chromeless.html()

inputValue(selector): 获取输入框值

const value = await chromeless.inputValue('#username')

exists(selector): 检查元素是否存在

const isExist = await chromeless.exists('.popup')

5. 截图与PDF生成

screenshot(selector, options): 截图

const screenshot = await chromeless
  .goto('https://example.com')
  .screenshot('header', {omitBackground: true})

pdf(options): 生成PDF

const pdf = await chromeless
  .goto('https://example.com')
  .pdf({landscape: true})

6. Cookie管理

cookies(): 获取当前页面所有cookie

const cookies = await chromeless.cookies()

setCookies(name, value): 设置cookie

await chromeless.setCookies('session', '12345')

clearCookies(): 清除所有cookie
```
await chromeless.clearCookies()
```

高级功能

执行页面脚本

使用evaluate()方法可以在页面上下文中执行JavaScript代码：

const result = await chromeless.evaluate(() => {
  return document.title
})

修改页面内容

通过setHtml()可以直接修改页面HTML：

await chromeless.setHtml('<h1>新内容</h1>')

文件上传

使用setFileInput()处理文件上传：

await chromeless.setFileInput('#file-upload', '/path/to/file.jpg')

最佳实践建议

合理使用等待机制：结合implicitWait选项和显式wait()调用，确保元素加载完成后再进行操作。
错误处理：所有API方法都返回Promise，建议使用try-catch处理可能出现的错误。
资源清理：操作完成后调用end()方法释放资源：

try {
  await chromeless.goto('https://example.com')
  // 执行操作...
} catch (error) {
  console.error('操作失败:', error)
} finally {
  await chromeless.end()
}