如何通过Karate ChromeDriver启用PDF文件下载？解决PDF链接点击后在新标签打开而非本地下载的问题

我之前也碰到过一模一样的问题，试了好几个配置才搞定，给你几个可行的方案参考：

1. 完善ChromeOptions的下载偏好配置 #

你之前的配置可能缺了关键的下载目录指定，Chrome需要明确知道文件要下载到哪个文件夹，才会跳过预览直接触发下载。试试这个完整的配置：

karate.configure('driver', {
  type: 'chromedriver',
  executable: path,
  webDriverSession: {
    desiredCapabilities: {
      browserName: 'chrome',
      "goog:chromeOptions": {
        prefs: {
          "download.default_directory": "/绝对路径/到/你的/下载文件夹", // 替换成实际存在的绝对路径
          "download.prompt_for_download": false, // 禁用下载确认弹窗
          "download.directory_upgrade": true, // 自动升级目录权限
          "pdfjs.disabled": true,
          "plugins.always_open_pdf_externally": true,
          "plugins.plugins_disabled": ["Chrome PDF Viewer"]
        },
        args: ["--disable-extensions", "--disable-plugins"] // 强制禁用可能干扰的插件
      }
    }
  }
});

重点提醒：download.default_directory必须是绝对路径，而且要确保这个文件夹已经存在，Chrome不会自动创建目录，路径不存在的话可能还是会回到预览模式。

2. 检查Karate版本兼容性 #

如果你的Karate版本比较旧（比如1.0.x及以下），可能在解析ChromeOptions的嵌套配置时有bug。建议升级到1.3.0以上的稳定版本，新版本对WebDriver的配置支持更完善。

3. 修改PDF链接的target属性 #

有时候新标签页打开的行为会干扰Chrome的下载逻辑，你可以在点击链接前用JS把链接的target改成当前页：

// 定位到PDF链接（根据实际页面调整选择器）
* script("document.querySelector('a[href$=\".pdf\"]').setAttribute('target', '_self')")
// 再点击链接
* click('a[href$=".pdf"]')

这样点击后PDF会在当前标签页触发下载，配合前面的Chrome配置就能跳过预览了。

你可以先试第一个方案，这是最常用的解决方法，大部分情况下都能搞定。如果还是不行，再结合版本升级和修改target属性的方式试试。

内容的提问来源于stack exchange，提问作者Srinivasu Kaki