Cypress 运行时无法直接访问 Node.js 的 process.argv，因其测试代码在浏览器环境中执行；正确方式是通过 --env 传递自定义环境变量，并在测试中使用 Cypress.env() 读取。
cypress 运行时无法直接访问 node.js 的 `process.argv`，因其测试代码在浏览器环境中执行；正确方式是通过 `--env` 传递自定义环境变量，并在测试中使用 `cypress.env()` 读取。
在 Cypress 自动化测试中，常需根据不同的 npm 脚本（如 npm run suite、npm run e2e-headless）动态调整测试行为（例如启用特定日志、跳过某些步骤或上报执行上下文）。但许多开发者误以为可在测试文件（如 test.js）中直接使用 process.argv 获取命令行参数——这是不可行的：Cypress 的测试代码运行在浏览器上下文中（Electron/Chrome），而非 Node.js 进程，因此 process.argv 不可用，且 process 对象本身在浏览器中并不存在。
✅ 正确方案：利用 Cypress 内置的环境变量机制（--env），将脚本标识注入测试运行时：
- 在 package.json 中为每个 script 添加 --env cli=xxx 参数：
"scripts": {
"e2e-headless": "cypress run --spec cypress/integration/examples/allSpec.js --browser chrome --env cli=e2e-headless",
"e2e": "cypress run --spec cypress/integration/examples/allSpec.js --browser chrome --headed --env cli=e2e",
"suite": "cypress run --spec cypress/integration/examples/Suite.js --browser chrome --headed --env cli=suite"
}
✅ 注意：--env 后接键值对（key=value），多个变量用逗号分隔，如 --env cli=suite,debug=true。
- 在测试文件（如 cypress/integration/examples/Suite.js 或 support/e2e.js）中读取：
// 获取当前执行的脚本标识
const scriptName = Cypress.env('cli');
// 验证是否成功获取（可在 before 里打印调试）
before(() => {
cy.log(`✅ Running via script: ${scriptName}`);
// 可进一步做逻辑分支
if (scriptName === 'suite') {
cy.log('→ This is a full suite execution');
}
});
it('demonstrates script-aware behavior', () => {
expect(scriptName).to.be.oneOf(['e2e-headless', 'e2e', 'suite']);
});
⚠️ 注意事项：
- Cypress.env() 只能在测试上下文（describe/it/before 等钩子）或 cypress/support/e2e.js 中安全使用；不可在 cypress.config.js 或 Node.js 预处理阶段直接调用（此时 Cypress 尚未启动）。
- 若需在配置层（如 cypress.config.js）区分环境，应改用 Cypress.config() + CLI --config 或 CYPRESS_* 环境变量（如 CYPRESS_CLI=suite），再通过 defineConfig 动态合并。
- cross-env 在此场景不适用：它仅用于设置 Node.js 进程环境变量，而 Cypress 测试代码不继承该进程的 process.env（除非显式通过 --env 桥接）。
? 扩展建议：可将 cli 值与 Cypress.spec.name 结合，构建更精细的执行上下文标识，例如用于测试报告归类或 CI/CD 流水线标记。
