使用Puppeteer非无头模式下无法加载Chrome扩展的问题求助

现有实现的错误点 #

• 参数挂载位置错配：ignoreDefaultArgs的作用是屏蔽Puppeteer默认传递给Chrome的启动参数，并非传入自定义参数的配置位。将扩展加载参数、--enable-automation放入该数组，既不会把参数真正下发给Chrome进程，还会触发对同名字段默认参数的排除逻辑——比如你本意是保留--enable-automation对应的自动化提示条，实际操作后反而会将这个默认参数屏蔽，连自动化提示都会消失。
• 缺少扩展加载的必填触发参数：仅配置--disable-extensions-except不会让Chrome主动加载扩展，必须搭配对应加载指令才能生效。
• 代码存在隐性缺陷：脚本中调用的sleep方法无全局定义，正常运行时会抛出未定义错误，无报错的表现大概率是运行环境提前对该方法做了兼容封装。

可运行的正确配置 #

加载本地未打包扩展，需要在args配置项中传入成对的启动参数，确保路径为扩展的本地绝对路径：

• --disable-extensions-except=<扩展路径>：限定仅允许加载指定路径的扩展，屏蔽其他无关扩展的干扰
• --load-extension=<扩展路径>：告知Chrome进程主动加载目标扩展包

修正后的代码示例：

// 扩展本地绝对路径
const stayFocusdExtPath = 'C:\\Users\\vasilis\\AppData\\Local\\Google\\Chrome\\User Data\\Default\\Extensions\\laankejkbhbdhmipfmgcngdelahlfoji\\1.6.0_0';

async function run() {
  const browser = await puppeteer.launch({
    headless: false,
    // 自定义启动参数统一挂载在args数组中
    args: [
      `--disable-extensions-except=${stayFocusdExtPath}`,
      `--load-extension=${stayFocusdExtPath}`
    ]
  });

  const page = await browser.newPage();
  // 替换未定义的sleep为原生延时实现
  await new Promise(resolve => setTimeout(resolve, 3000));

  await browser.close();
}

run();

实操注意事项 #

• 不建议直接加载Chrome用户数据目录下的已安装扩展子目录，最好将扩展文件单独拷贝到独立的本地文件夹，避免用户目录的权限校验、版本缓存问题导致加载失败。
• 旧版默认无头模式不支持扩展加载，需要切换为headless: 'new'才能兼容扩展逻辑，当前headless: false的场景不受该限制。
• 不要使用ignoreDefaultArgs: true全局排除所有默认启动参数，会直接导致Chrome启动异常。

内容的提问来源于stack exchange，提问作者vasilis 123