Puppeteer的BrowserFetcher遭移除：求问原因、时间及替代方案

架构老林

2026-7-11

关于Puppeteer中createBrowserFetcher/BrowserFetcher移除的说明及替代方案

移除时间

createBrowserFetcher和BrowserFetcher在Puppeteer v21.0.0版本中被正式移除。

移除原因

核心原因是Puppeteer的架构重构：官方将浏览器下载、管理的核心逻辑从主包中拆分，整合到独立的@puppeteer/browsers工具包中，目的是简化主API的复杂度，统一浏览器版本管理逻辑，避免功能重复实现，同时让浏览器管理功能可以被其他工具复用。

替代方案

1. 依赖`puppeteer`自动下载（推荐）

安装puppeteer包时，会自动下载与当前版本兼容的Chromium，无需手动处理：

npm install puppeteer

2. 手动下载后指定路径

如果需要自行下载特定版本的Chromium，可以从Chrome for Testing资源页面获取对应平台的安装包，解压后在启动Puppeteer时通过executablePath指定路径：

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: '/your/path/to/chromium'
  });
  // 执行后续操作
  await browser.close();
})();

3. 使用官方拆分的`@puppeteer/browsers`包

这是官方推出的替代BrowserFetcher的工具包，提供了完整的浏览器下载、版本管理API：
首先安装包：

npm install @puppeteer/browsers

然后使用downloadBrowser方法下载浏览器：

const { downloadBrowser } = require('@puppeteer/browsers');

(async () => {
  // 下载稳定版Chrome，也可指定具体版本号如'118.0.5993.70'
  const browserPath = await downloadBrowser('chrome', 'stable');
  console.log('浏览器已下载至:', browserPath);
})();