Nightwatch项目Chrome浏览器指定相对下载路径配置咨询

我来帮你搞定这个问题——先理清楚两个核心点：Chrome的默认下载目录位置，以及怎么把它改成你项目根目录下的指定路径。

Chrome默认下载目录在哪？ #

Chrome默认会把文件丢到系统自带的下载文件夹：

• Windows：C:\Users\<你的用户名>\Downloads
• Mac：~/Downloads（也就是用户主目录下的Downloads文件夹）
• Linux：~/Downloads

不过我们完全可以通过自定义Chrome启动参数来修改这个路径，Nightwatch刚好支持配置Chrome的这些选项。

怎么配置到项目根目录的指定相对路径？ #

Chrome要求下载路径必须是绝对路径，所以我们得先把项目根下的相对路径转成绝对路径，再配置到Nightwatch的Chrome设置里。具体步骤如下：

1. 在Nightwatch配置文件中设置下载路径

假设你的Nightwatch配置文件是nightwatch.conf.js（一般放在项目根目录），先引入Node.js的path模块处理路径，再定义你的目标下载目录：

const path = require('path');
// 这里的'./downloads'就是你项目根下的相对路径，改成你需要的文件夹名就行
const targetDownloadPath = path.resolve(__dirname, './downloads');

接着在配置的test_settings里的Chrome相关配置中，添加goog:chromeOptions的prefs设置：

module.exports = {
  // 其他配置项...
  test_settings: {
    default: {
      desiredCapabilities: {
        browserName: 'chrome',
        'goog:chromeOptions': {
          prefs: {
            // 设定自定义下载目录
            'download.default_directory': targetDownloadPath,
            // 禁用下载确认弹窗（你说本来就没有，但这个设置能确保万无一失）
            'download.prompt_for_download': false,
            // 如果目录不存在，允许Chrome创建它（不过还是建议提前手动创建）
            'download.directory_upgrade': true,
            // 可选：启用安全浏览，避免下载时的安全提示干扰测试
            'safebrowsing.enabled': true
          }
        }
      }
    }
  }
};

2. 确保目标文件夹存在

虽然download.directory_upgrade允许Chrome自动创建目录，但有时候可能会因为权限问题失败，所以建议在测试开始前手动创建文件夹。可以在测试套件的before钩子中加入这段代码：

const fs = require('fs');

module.exports = {
  // 在所有测试启动前执行
  before: function(browser) {
    if (!fs.existsSync(targetDownloadPath)) {
      // recursive: true 会自动创建多级嵌套目录
      fs.mkdirSync(targetDownloadPath, { recursive: true });
      console.log(`已创建下载目录：${targetDownloadPath}`);
    }
  },
  // 其他测试钩子或用例...
};

3. 验证配置是否生效

运行测试后点击下载按钮，去项目根下的目标文件夹看看，应该就能找到下载的文件了。如果没生效，可以检查这几点：

• 路径是否正确：可以用console.log(targetDownloadPath)输出绝对路径，确认是不是你要的位置
• 文件夹权限：确保当前用户有读写该文件夹的权限
• Nightwatch版本：如果是v2+，配置结构基本一致，若遇到问题可以核对官方文档的Chrome配置部分（核心的prefs设置是通用的）

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