Cypress如何为含动态名称的已下载文件添加断言？

要验证以ABC开头加动态ID的XLSX文件下载，你可以按照以下步骤操作，核心是通过Node.js任务访问文件系统，结合断言验证文件名规则和文件存在性：

1. 配置下载路径与Node任务 #

首先在cypress.config.js中指定固定的下载文件夹，并注册两个Node任务：获取下载文件列表、清空下载文件夹（避免历史文件干扰）：

const { defineConfig } = require('cypress')
const fs = require('fs')
const path = require('path')

module.exports = defineConfig({
  e2e: {
    // 指定下载文件存放目录
    downloadsFolder: 'cypress/downloads',
    setupNodeEvents(on, config) {
      on('task', {
        // 获取指定文件夹内的所有文件名
        getDownloadedFiles(folder) {
          return fs.readdirSync(folder)
        },
        // 清空下载文件夹
        clearDownloads(folder) {
          fs.readdirSync(folder).forEach(file => {
            fs.unlinkSync(path.join(folder, file))
          })
          return null
        }
      })
    }
  }
})

2. 编写测试用例 #

在测试用例中，先清空下载目录，触发下载操作，再验证文件：

describe('验证XLSX文件下载', () => {
  beforeEach(() => {
    // 每次测试前清空下载文件夹，避免旧文件干扰
    cy.task('clearDownloads', Cypress.config('downloadsFolder'))
  })

  it('下载的文件符合ABC+动态ID的命名规则', () => {
    // 1. 触发下载操作（替换成你的实际下载按钮选择器）
    cy.get('#download-xlsx-btn').click()

    // 2. 等待下载完成（根据文件大小调整等待时间，或用轮询优化）
    cy.wait(2000)

    // 3. 获取下载文件夹内的所有文件
    cy.task('getDownloadedFiles', Cypress.config('downloadsFolder')).then(files => {
      // 筛选出以ABC开头、xlsx结尾的文件
      const matchedFiles = files.filter(file => 
        file.startsWith('ABC') && file.endsWith('.xlsx')
      )

      // 断言至少存在一个符合条件的文件
      expect(matchedFiles).to.have.length.greaterThan(0, '未找到符合命名规则的XLSX文件')

      // 验证文件名格式：ABC + 数字 + .xlsx
      const targetFile = matchedFiles[0]
      const fileNameRegex = /^ABC\d+\.xlsx$/
      expect(targetFile).to.match(fileNameRegex, `文件名${targetFile}不符合ABC+数字的规则`)

      // 可选：验证文件不为空（确保下载完整）
      cy.readFile(`${Cypress.config('downloadsFolder')}/${targetFile}`).then(content => {
        expect(content.length).to.be.greaterThan(0, '下载的文件为空')
      })
    })
  })
})

关键优化说明 #

• 轮询替代固定等待：如果固定等待时间不够可靠，可以用递归轮询确保文件生成：

  cy.wrap(null).then(function checkFile() {
    cy.task('getDownloadedFiles', Cypress.config('downloadsFolder')).then(files => {
      const matched = files.some(f => f.startsWith('ABC') && f.endsWith('.xlsx'))
      if (!matched) {
        cy.wait(500)
        return checkFile() // 递归轮询直到找到文件
      }
    })
  })
  

• 灵活调整正则：如果动态ID包含字母或其他字符，可修改正则规则，比如允许字母数字：/^ABC[A-Za-z0-9]+\.xlsx$/

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