如何在Playwright中使用现有Chrome/Chromium用户配置文件启动浏览器

要在Playwright中加载已有的Chrome用户配置文件，你需要在chromium.launch()的配置里使用**userDataDir**属性（注意是驼峰命名，而非你示例中的下划线格式），同时指定channel: 'chrome'调用本地安装的Chrome浏览器，而非Playwright自带的Chromium内核。

完整TypeScript代码示例 #

import { chromium } from '@playwright/test';

(async () => {
  // 替换为你本地Chrome用户数据目录的实际路径
  const chromeUserDataDir = 'C:\\Users\\Home\\AppData\\Local\\Google\\Chrome\\User Data';

  const browser = await chromium.launch({
    channel: 'chrome',
    userDataDir: chromeUserDataDir,
    // 如需可视化测试，开启以下配置
    headless: false
  });

  const page = await browser.newPage();
  await page.goto('https://example.com');
  // 编写你的测试逻辑

  await browser.close();
})();

关键注意事项 #

• 关闭运行中的Chrome实例：Chrome运行时会锁定用户数据目录，启动测试前必须关闭所有Chrome窗口，否则Playwright会抛出加载失败的错误。
• 路径格式处理：Windows系统下路径需使用双反斜杠\\或正斜杠/，避免转义字符冲突。
• 加载特定子配置文件：如果要使用Chrome内的特定用户配置（如Profile 1），直接指定子目录路径即可，例如：C:\\Users\\Home\\AppData\\Local\\Google\\Chrome\\User Data\\Profile 1。
• BrowserContext方式（可选）：若不想全局加载配置，可在启动浏览器后通过newContext()单独指定用户数据目录：

const browser = await chromium.launch({ channel: 'chrome' });
const context = await browser.newContext({
  userDataDir: 'C:\\Users\\Home\\AppData\\Local\\Google\\Chrome\\User Data'
});
const page = await context.newPage();

内容的提问来源于stack exchange，提问作者I.sh.