向Cypress任务传递含函数属性的对象并跨文件调用问题

首先明确一个关键限制：Cypress的cy.task在传递参数时会对数据进行JSON序列化，而函数是无法被JSON序列化的。这就导致你在测试代码里定义的additionalSteps函数，传到插件端时已经变成undefined了——这就是你调用时报错的根本原因。

再看你代码里的几个小问题：

• 你判断options.additionalSteps != 'undefined'是错误的，这里把字符串'undefined'和函数做比较，完全起不到判断作用。正确的做法应该是检查typeof options.additionalSteps === 'function'，不过这在当前场景下解决不了核心问题，因为函数已经被序列化丢失了。
• 在baseLoginConnect里你又用了同样的错误判断，而且打印的additionalSteps变量，在插件端已经是null或者undefined了。

可行的解决方案 #

方案1：将自定义逻辑移至插件端，通过标识触发 #

既然函数不能跨IPC传递，你可以在测试代码里传递一个标识（比如字符串），然后在插件端根据这个标识执行对应的预定义逻辑。这是最安全可靠的方案。

修改测试代码：

const socialLoginOptions = {
  // ... 其他属性
  additionalSteps: 'notificationCheck', // 用标识代替函数
  // ... 其他属性
}

然后在插件端的CustomizedLogin里：

// 先定义好所有可能的自定义步骤函数
const predefinedSteps = {
  notificationCheck: async ({page, options}) => {
    console.log('This is the additional step...')
    await page.waitForSelector('#header_notification_link', {visible: true})
    await page.click('#header_notification_link')
  }
}

module.exports.CustomizedLogin = async function CustomizedLogin(options = {}) {
  // ... 其他代码

  let additionsFound = false
  console.log('Before checking for additional steps...')
  // 根据标识获取对应的函数
  const additionalStepFn = predefinedSteps[options.additionalSteps]
  if (typeof additionalStepFn === 'function') {
    console.log('perform additional steps')
    await additionalStepFn({page, options})
    additionsFound = true
  }
}

方案2：将函数序列化为字符串（谨慎使用） #

如果你确实需要完全自定义逻辑，可以把函数转换成字符串传递，在插件端再通过new Function还原。注意这种方式有安全风险，只在你完全控制输入的情况下使用。

测试代码修改：

const socialLoginOptions = {
  // ... 其他属性
  additionalSteps: `async function({page, options}) {
    console.log('This is the additional step...')
    await page.waitForSelector('#header_notification_link', {visible: true})
    await page.click('#header_notification_link')
  }`,
  // ... 其他属性
}

插件端处理：

module.exports.CustomizedLogin = async function CustomizedLogin(options = {}) {
  // ... 其他代码

  let additionsFound = false
  console.log('Before checking for additional steps...')
  if (typeof options.additionalSteps === 'string') {
    console.log('perform additional steps')
    // 还原函数
    const additionalStepFn = new Function(`return ${options.additionalSteps}`)()
    await additionalStepFn({page, options})
    additionsFound = true
  }
}

方案3：避免使用task，改用Cypress自定义命令 #

如果你的自定义逻辑不需要在Node环境（插件端）执行，而是可以在浏览器端运行，那可以把这部分逻辑做成Cypress自定义命令，直接在测试代码里调用，不需要跨进程传递函数。

总结 #

跨文件传递函数本身在普通Node.js场景是可行的，但Cypress的cy.task因为IPC序列化的限制，无法直接传递函数。上面的方案里，方案1是最推荐的安全可靠方案；方案2适合需要高度自定义的场景，但要注意安全风险；方案3适合浏览器端能执行的逻辑。

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