如何向Cypress创建的所有Node实例传递--dns-result-order=ipv4first参数

以下是几种无需依赖官方文档标准支持的实现方式：

1. 利用NODE_OPTIONS环境变量全局注入 #

Node.js会自动读取NODE_OPTIONS环境变量中的参数，并将其应用到当前进程及所有衍生的Node子进程中。直接在执行Cypress命令前设置该变量即可：

# Linux/macOS 终端
NODE_OPTIONS="--dns-result-order=ipv4first" cypress run

# Windows 命令提示符
set NODE_OPTIONS=--dns-result-order=ipv4first && cypress run

# Windows PowerShell
$env:NODE_OPTIONS="--dns-result-order=ipv4first"; cypress run

这种方式能确保Cypress启动的所有Node实例（包括测试运行器、浏览器驱动进程等）都继承该参数，是最简便的全局生效方案。

2. 本地安装时直接通过Node命令启动Cypress #

如果项目是通过npm/yarn本地安装的Cypress，可以修改package.json中的启动脚本，直接用Node命令执行Cypress启动文件并传递参数：

{
  "scripts": {
    "test:e2e": "node --dns-result-order=ipv4first ./node_modules/cypress/bin/cypress run"
  }
}

执行npm run test:e2e即可启动Cypress，此方法可确保Cypress主进程加载指定参数，若需覆盖所有子进程，建议结合NODE_OPTIONS使用。

3. 通过Cypress插件配置细粒度控制 #

在项目的cypress.config.js中，利用插件API显式为特定进程添加参数，同时设置环境变量覆盖所有子进程：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      // 为Chromium系浏览器的驱动进程添加参数
      on('before:browser:launch', (browser = {}, launchOptions) => {
        if (browser.family === 'chromium' && browser.name !== 'electron') {
          launchOptions.args.push('--dns-result-order=ipv4first')
        }
        return launchOptions
      })

      // 全局设置环境变量，确保所有衍生Node进程继承参数
      process.env.NODE_OPTIONS = `${process.env.NODE_OPTIONS || ''} --dns-result-order=ipv4first`.trim()

      return config
    },
  },
})

这种方式适合需要针对特定进程类型调整参数的场景，同时兼顾全局生效的需求。

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