Playwright无头模式下无法捕获新标签页URL问题求助

核心问题原因 #

无头模式（尤其是Chromium旧版无头）与有头模式的浏览器行为存在差异，PDF弹窗的加载流程在无头环境下会有延迟，你捕获到popup时，页面还处于初始的about:blank状态，尚未完成PDF地址的跳转。

实用解决方案 #

1. 切换到新版无头模式 #

Playwright 1.30+支持更贴近有头浏览器的新版无头模式，替换原配置中的headless: true为：

use: {
  headless: 'new',
}

新版无头的行为逻辑和有头模式几乎一致，能解决大部分兼容性差异问题。

2. 等待页面完成跳转后再断言URL #

捕获popup后不要立刻断言，先等待页面跳转到PDF地址，比如用正则匹配PDF后缀：

const popupPromise = page.waitForEvent('popup');
await productAttachment.element.click();
const popup = await popupPromise;
// 等待URL变为PDF地址，可根据实际情况调整超时时间
await popup.waitForURL(/\.pdf$/, { timeout: 15000 });
await expect(popup).toHaveURL(/\.pdf$/);

3. 配置PDF相关浏览器参数 #

启动浏览器时添加参数，确保无头模式下正常处理PDF：

const browser = await chromium.launch({
  headless: 'new',
  args: [
    '--disable-pdfjs', // 禁用内置PDF阅读器，让浏览器直接打开PDF页面（按需使用）
    '--allow-file-access-from-files', // 本地PDF场景可能需要该参数
  ],
});

4. 等待页面完全加载完成 #

等待popup的load事件触发后再断言，确保URL稳定：

const popupPromise = page.waitForEvent('popup');
await productAttachment.element.click();
const popup = await popupPromise;
await popup.waitForLoadState('load'); // 等待页面全部资源加载完成
await expect(popup).toHaveURL(yourExpectedPDFUrl);

额外排查点 #

• 确认PDF链接是直接打开而非触发下载，如果是下载行为，应使用Playwright的下载API处理，而非popup事件。
• 检查是否存在页面重定向，可能需要等待重定向流程完成后再进行断言。

内容的提问来源于stack exchange，提问作者Michał Ziętek