如何用Mocha Assert在JavaScript中正确校验文件下载结果

你当前测试用例的执行流程是完全同步的：调用downloadFile触发异步下载逻辑后，代码没有做任何等待就立刻向下执行文件存在性检查、断言逻辑，相当于下载流程刚启动就被打断去跑断言，自然会在文件还没落盘的时候抛出断言错误。
你之前尝试用done回调失败，本质是因为done的调用被写在了同步执行流里，根本没有和downloadFile的完成事件绑定，相当于下载还没开始就直接告诉Mocha测试跑完了。
你观察到的“保留旧下载文件时测试就通过”的现象，本质是旧文件提前存在，同步检查的时候能直接匹配到已存在的文件，形成了测试通过的假象，并非异步流程被正确等待了。

• 核心修复逻辑：必须等downloadFile的内部下载、文件写入流程完全结束后，再执行文件存在性的断言，不能在调用完下载方法后立刻跑检查。
• 如果downloadFile是符合JS规范的、返回Promise的异步函数（当前绝大多数异步下载实现都是这个形式），可以直接把Mocha的测试回调改成async函数，用await关键字等待下载函数执行完成，不需要手动维护done回调，避免手动调用时机出错。
• 修正后的可运行代码示例：

import assert from 'assert';
import {downloadFile} from './src/savefile.js';
import appRoot from 'app-root-path';
import fs from 'fs';

describe("save file", () => {
    // 测试前先清理旧的测试文件，避免旧文件干扰测试结果
    beforeEach(() => {
        const targetPath = appRoot.resolve('testFile.dat');
        if (fs.existsSync(targetPath)) {
            fs.unlinkSync(targetPath);
        }
    });

    it("file should be saved", async () => { 
        // 关键：await等待下载流程完全执行完成，文件落盘后再往下走
        await downloadFile('testFile.dat');
        const targetPath = appRoot.resolve('testFile.dat');
        assert(
            fs.existsSync(targetPath),
            "预期下载完成的文件未在目标路径找到"
        );
    });
});

• 额外排查注意点：如果downloadFile本身的实现存在问题——比如没有把文件写入的流关闭、写入操作完成的时机作为函数resolve/回调触发的节点，那测试侧的等待逻辑也不会生效。需要确保downloadFile内部是在文件完全写入磁盘、操作系统确认文件落盘后，才结束异步流程。

注意：如果你的downloadFile是基于回调风格实现的旧代码，可以把它包装成Promise再等待，不要直接调用完就跑断言。

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