在Cypress中使用parse-pdf时出现fs.readFileSync is not a function错误

云上老周

2026-7-12

解决Cypress中调用fs.readFileSync出现「fs.readFileSync is not a function」的问题

问题原因

Cypress的测试代码默认运行在浏览器上下文，而fs是Node.js专属的原生文件系统模块，浏览器环境没有该模块的实现，直接调用就会抛出这个错误。

两种可行解决方案

方案一：用Cypress内置命令`cy.readFile()`替代

Cypress提供了专门的文件读取命令，无需依赖Node.js的fs模块，适合读取文件后结合parse-pdf处理：

// 以二进制格式读取PDF文件
cy.readFile('path/to/your/target.pdf', 'binary').then(pdfBinary => {
  // 将二进制内容转为buffer，传给parse-pdf解析
  const pdfBuffer = Buffer.from(pdfBinary, 'binary');
  parsePdf(pdfBuffer).then(parsedData => {
    // 在这里处理解析后的PDF数据
    console.log(parsedData);
  });
});

方案二：通过Cypress Task在Node.js环境执行代码

如果必须依赖Node.js的fs模块，可通过Cypress的task机制，在Node.js上下文执行文件读取和PDF解析逻辑：

修改cypress.config.js，注册自定义task：

const { defineConfig } = require("cypress");
const parsePdf = require('parse-pdf');

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('task', {
        async parsePdfWithFs(filePath) {
          const fs = require('fs');
          // 读取PDF文件buffer
          const pdfBuffer = fs.readFileSync(filePath);
          // 调用parse-pdf解析
          return await parsePdf(pdfBuffer);
        }
      });
    },
  },
});

在测试代码中调用该task：

cy.task('parsePdfWithFs', 'path/to/your/target.pdf').then(parsedPdfData => {
  // 处理解析后的PDF数据，比如断言内容
  expect(parsedPdfData.pages[0].text).to.include('目标文本');
});