使用Cypress Task结合xlsx读取Excel时出现f.slice报错求助

报错原因 #

1. 参数传递错误：xlsx的read方法需要接收Buffer/ArrayBuffer等可切片的内容作为第一个参数，但你直接将包含buffer的对象{buffer}传给任务，xlsx会把这个对象当作处理目标，而对象没有slice方法，导致报错。
2. 任务注册方式错误：直接挂载readXlsx.read到Cypress任务，会导致方法的上下文和参数传递不符合Cypress Task的要求。
3. 数据解析错误：将返回的行数据强制转为string后取length，无法正确获取Excel的实际行数。

具体修复步骤 #

1. 修改Cypress任务注册（cypress.config.js）

在Node环境中包装xlsx的读取逻辑，确保正确处理参数并返回解析后的行数据：

const XLSX = require('xlsx');
const { defineConfig } = require('cypress');

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('task', {
        // 自定义任务：接收文件路径，读取并解析Excel
        readXlsx: ({ filePath }) => {
          // 直接在Node环境读取Excel文件
          const workbook = XLSX.readFile(filePath);
          // 获取第一个工作表名称
          const firstSheet = workbook.SheetNames[0];
          // 获取工作表数据
          const worksheet = workbook.Sheets[firstSheet];
          // 将工作表转为二维数组（header:1表示保留表头为第一行）
          const rows = XLSX.utils.sheet_to_json(worksheet, { header: 1 });
          return rows;
        },
      });
    },
  },
});

2. 调整任务调用代码

移除浏览器上下文的fs.readFileSync调用，直接将文件路径传给Cypress Task：

private validateExcelFile(countedItems: number, correction: number) {
  cy.get('@LASTDOWNLOADEDFILE').then((name) => {
    const fileName = name as string;
    cy.log(`Validating excel file: ${fileName}`);

    cy.task('readXlsx', { filePath: fileName }).then((rows) => {
      // rows是二维数组，rows.length即为Excel的总行数
      expect(rows.length).to.equal(countedItems - correction);
    });
  });
}

可选：如果需要传递Buffer的场景 #

若必须在调用端读取Buffer再传给任务，需修改任务逻辑指定type: 'buffer'：

// 任务注册修改为
readXlsx: ({ buffer }) => {
  const workbook = XLSX.read(buffer, { type: 'buffer' });
  const firstSheet = workbook.SheetNames[0];
  const worksheet = workbook.Sheets[firstSheet];
  const rows = XLSX.utils.sheet_to_json(worksheet, { header: 1 });
  return rows;
}

调用端保持原fs.readFileSync逻辑，但注意：Cypress命令回调中的代码运行在浏览器上下文，使用fs可能存在环境限制，优先推荐在Task中读取文件。

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