puppeteer 系列模块的系统性、详细讲解

puppeteer 系列模块的系统性、详细讲解

🧩 一、核心模块介绍

1. puppeteer

全功能 Puppeteer 包，默认包含 Chromium 浏览器

npm install puppeteer

• 包含内容：Puppeteer API + Chromium 浏览器
• 适合场景：
  • 想直接运行，不关心浏览器版本（直接附带一个稳定 Chromium）
  • 本地开发、调试用
• 缺点：
  • 体积大（100M+）
  • 安装慢，尤其在 CI/CD、国内网络中不便

2. puppeteer-core

轻量版 Puppeteer，不包含 Chromium

npm install puppeteer-core

• 只包含 API：必须手动指定或连接已有的浏览器
• 适合场景：
  • 想使用自定义浏览器版本（如 Chrome 稳定版）
  • 避免重复下载浏览器（节省磁盘与网络）
• 常配合：

const browser = await puppeteer.launch({
  executablePath: '/path/to/your/chrome'
});

3. puppeteer-extra

用于增强 Puppeteer 功能的框架包

npm install puppeteer-extra

• 基于 puppeteer-core 封装

• 提供插件机制：可加载多个插件增强能力

• 常见插件：

  • puppeteer-extra-plugin-stealth：防止被识别为自动化脚本
  • puppeteer-extra-plugin-adblocker：广告屏蔽器

• 使用方式

const puppeteer = require('puppeteer-extra');
puppeteer.use(require('puppeteer-extra-plugin-stealth')());

• ✅ 优势：

  • 插件机制灵活
  • 安装更轻量（和 puppeteer-core 结合）

4. puppeteer-extra-plugin-stealth

用于绕过反爬虫检测的核心插件

npm install puppeteer-extra-plugin-stealth

• 绕过检测能力（以下是它覆盖的一些特征）：

• 使用方法

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');

puppeteer.use(StealthPlugin());

const browser = await puppeteer.launch({
  headless: false
});

📦 二、推荐组合使用方式

示例：抗检测稳定组合

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');
puppeteer.use(StealthPlugin());

(async () => {
  const browser = await puppeteer.launch({
    headless: false,
    executablePath: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', // 你的 Chrome 安装路径
    args: ['--no-sandbox', '--disable-blink-features=AutomationControlled']
  });

  const page = await browser.newPage();
  await page.goto('https://www.google.com');
})();

🧠 三、常见问题与建议

✅ 总结