How to verify if a file is downloaded in Cypress?

在使用 Cypress 进行自动化测试时，验证文件是否已成功下载通常涉及以下步骤：

1. 设置文件下载路径

首先，您需要设置 Cypress 以便它知道在哪里查找下载的文件。这可以通过在 cypress.json 配置文件中指定 downloadsFolder 来实现。例如：

json
{
  "downloadsFolder": "cypress/downloads"
}

这意味着所有通过测试下载的文件都将保存在项目的 cypress/downloads 目录中。

2. 触发文件下载

在测试中，您需要模拟或触发一个下载文件的动作。这通常是通过点击一个链接或按钮实现的。例如：

javascript
cy.get('.download-button').click();

3. 验证文件是否存在

下载文件后，您需要验证文件实际上已经被下载到指定的文件夹中。这可以通过使用 cy.readFile 或 cy.task 命令来实现。例如，如果您期待一个名为 report.pdf 的文件被下载，您可以使用以下代码来检查这个文件是否存在：

javascript
cy.readFile('cypress/downloads/report.pdf').should('exist');

4. （可选）验证文件内容

如果需要，您还可以进一步验证下载的文件内容是否符合预期。使用 cy.readFile 不仅可以检查文件是否存在，还可以读取其内容，例如：

javascript
cy.readFile('cypress/downloads/report.pdf').then((content) => {
  expect(content).to.include('Expected Content in PDF');
});

示例场景

假设我们在一个项目管理系统中测试导出功能，用户可以导出项目报告为 PDF 文件。测试脚本可能如下：

javascript
describe('Project Report Download', () => {
  it('should download the project report successfully', () => {
    // 登录
    cy.login('user@example.com', 'password'); // 假设 login 是一个自定义命令
    // 导航到项目页面
    cy.visit('/projects/123');
    // 点击下载报告按钮
    cy.get('.download-report-btn').click();
    // 检查报告是否下载
    cy.readFile('cypress/downloads/project-report-123.pdf').should('exist');
    // （可选）检查报告内容
    cy.readFile('cypress/downloads/project-report-123.pdf').then((content) => {
      expect(content).to.include('Project Overview');
    });
  });
});

以上就是在 Cypress 中验证文件下载的基本步骤和一个示例场景。通过这种方式，您可以确保文件下载功能在自动化测试中得到正确验证。