如何在Cypress中将断言默认报错信息替换为自定义纯提示内容

你原来的Chai断言写法之所以会拼接默认输出，是因为Chai的自定义报错参数仅作为错误前缀，默认会自动拼接断言上下文内容，无法单独仅输出自定义信息。可以通过以下两种方案实现需求：

方案1：手动判断+主动抛错（最直接） #

直接在should回调里判断内容是否符合要求，不符合就主动抛出仅携带自定义信息的错误即可，Cypress会直接输出你抛出的错误内容：

cy.get('@content').should(($txt) => {
  // 检测到包含禁用字符串时直接抛出自定义错误
  if ($txt.includes('text that should not be in the content')) {
    throw new Error('Custom error message')
  }
})

方案2：把判断逻辑下沉到Task层（大文件更推荐） #

如果是处理大体积PDF文件，把整个文件内容传到Cypress浏览器命令链会额外消耗性能，你可以直接在cypress.config.js的task定义里完成内容校验，只把校验结果返回给用例层：
首先修改Task定义：

// cypress.config.js 中配置Task
const { parsePdf } = require('你的pdf解析工具路径')

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('task', {
        async checkPdfNoForbiddenText({ filePath, forbiddenText }) {
          const pdfContent = await parsePdf(filePath)
          // 返回是否不包含禁用字符串
          return !pdfContent.includes(forbiddenText)
        }
      })
    }
  }
})

用例层调用：

cy.task('checkPdfNoForbiddenText', {
  filePath: '你的PDF文件路径',
  forbiddenText: 'text that should not be in the content'
}).then((isValid) => {
  if (!isValid) {
    throw new Error('Custom error message')
  }
})

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