使用Cypress处理Excel文件时报"path"参数类型错误问题问询

报错根因 #

报错为参数传递不匹配导致，共2处核心错误：

1. 自定义命令未接收入参，且给task传递了对象而非路径字符串
   你定义的parseXlsx自定义命令没有设置参数接收逻辑，测试代码中调用cy.parseXlsx(name)传入的下载文件名没有被接住；同时命令内部给cy.task传的是{ filePath: InputFile }对象，而非直接的路径字符串。
2. task定义未匹配传参结构
   你在task定义中直接用parseXlsx(filePath)接收参数，此时拿到的是前端传来的整个对象，而非对象里的路径值，自然会触发「path参数收到Object」的类型错误。

修复步骤 #

1. 修正自定义命令（cy-commands.ts） #

移除硬编码的InputFile引用，增加参数接收逻辑：

// 直接给task传路径字符串，改动最小
Cypress.Commands.add('parseXlsx', (filePath: string) => cy.task('parseXlsx', filePath));

如果需要保留对象传参的格式，需同步修改task的解构逻辑。

2. 修正plugin/index.js的task定义 #

补充路径拼接逻辑，避免相对路径读取失败：

module.exports = (on, config) => {
  on('task', {
    parseXlsx(filePath) {
      return new Promise((resolve, reject) => {
        try {
          // 拼接下载目录完整路径，适配下载文件的默认存储位置
          const fullPath = path.resolve(config.downloadsFolder, filePath);
          const jsonData = xlsx.parse(fs.readFileSync(fullPath));
          resolve(jsonData);
        } catch (e) {
          reject(e);
        }
      });
    },
  });
}

3. 修复测试代码的字段错误 #

node-xlsx解析返回的行数据字段为data而非dataset，修正后代码如下：

validateExcelFileNotEmpty() {
  cy.get('@LASTDOWNLOADEDFILE').then((fileName: string) => {
    cy.log(`Validating excel file: ${fileName}`);
    cy.parseXlsx(fileName).then((jsonData: Array<any>) => {
      const rowLength = jsonData[0].data.length;
      expect(rowLength).to.be.greaterThan(0); // 补充非空断言
    });
  });
}

通用排查思路 #

• 出现参数类型错误时，优先在task入口打印接收到的参数值和类型，确认前后端传参结构是否匹配
• 文件读取报错时，先打印完整路径确认目标文件是否存在
• Cypress task的入参是前端传的完整数据，结构要前后端统一

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