开发工具【免费下载链接】mock-fsConfigurable mock for the fs module项目地址https://gitcode.com/gh_mirrors/mo/mock-fs点击查看免费下载做 Node.js 开发测试时你大概率被 fixture测试用临时文件折磨过手动创建一堆假文件、测完再清理、稍有不慎就把脏数据留在磁盘上。开源库mock-fs就是为了解决这个问题它把 Node.js 内置fs模块临时替换为一个内存中的 mock 文件系统让所有fs读写操作都发生在内存里测试结束调用一次mock.restore()即可完全还原从此告别磁盘上的测试 fixture 文件。mock-fs 解决了什么问题传统做法中文件相关的测试通常长这样测试前用真实fs在磁盘上创建一批假文件fixture跑测试测试后再写一堆清理代码这套流程有三大痛点慢每次都走真实磁盘 I/O脆测试异常中断后脏文件残留在磁盘上污染下一次运行难维护fixture 目录结构随业务膨胀改一处漏一处而 mock-fs 的思路是整体换盘它不逐个劫持fs.readFile、fs.mkdir这些方法而是直接替换 Node 底层的process.binding(fs)绑定相关实现见 lib/index.js从根源上让fs模块对接到内存文件系统。好处是几乎所有fs函数同步、异步、fs.promises都自动生效与graceful-fs等其他改造fs的库互不冲突无需为不同 Node 版本维护复制版的fs代码一键安装 mock-fs使用 npm 安装到开发依赖仅需 Node.js 12官方已测试 Node 1822npm install mock-fs --save-dev编写你的第一个 mock 文件系统require(mock-fs)默认导出的函数就是mock(config)传一个描述文件树的普通对象即可上盘const mock require(mock-fs); mock({ path/to/fake/dir: { some-file.txt: file content here, empty-dir: {} // 空目录 }, path/to/some.png: Buffer.from([8, 6, 7, 5, 3, 0, 9]) // 二进制文件 });调用之后你的代码中所有fs操作读到的就是这套内存文件树了。默认情况下mock-fs 还会自动为process.cwd()和os.tmpdir()各创建一个目录保证大部分程序开箱即用不想要可通过第二个参数createCwd/createTmp关闭。 小细节配置里的路径是相对process.cwd()的且在 Windows 上也请使用正斜杠/。三种节点写法文件、目录与符号链接config 对象的写法遵循看值定类型的直觉规则属性值创建内容string或Buffer文件内容即该值嵌套Object目录子属性即子节点mock.file({...})带元信息的文件权限mode、属主uid/gid、时间戳atime/mtime/ctime等mock.directory({...})带元信息的目录mode默认0777items描述子节点mock.symlink({path})符号链接必须显式调用无简写需要模拟一个权限为0755、时间戳可控的目录时mock({ some/dir: mock.directory({ mode: 0755, items: { file1: file one content } }) });三类节点的底层实现分别位于 lib/file.js、lib/directory.js 和 lib/symlink.js入口工厂函数在 lib/filesystem.js 中统一提供。从磁盘导入mock.load() 加载真实文件不想手抄内容mock.load(path, options)可以把真实磁盘上的文件或目录整体搬进 mock 系统且会保留 stat 信息时间戳、权限等mock({ // 惰性加载首次读取时才真正读盘 my-file.txt: mock.load(assets/special-file.txt), // 预加载{lazy: false} ready.js: mock.load(scripts/ready.js, {lazy: false}), // 递归加载整个目录 node_modules: mock.load(../node_modules) });两个常用选项lazy默认true文件内容延迟到首次读取时加载启动更快recursive默认true是否递归加载子目录实现细节可参考 lib/loader.js。需要摸真盘用 mock.bypass() 临时旁路mock 生效后读真实磁盘文件会扑空。如果测试中确实需要访问真实文件比如读日志、读配置用mock.bypass(fn)把函数体放到真实文件系统上执行// 该文件只存在于真实 FS不在 mock FS 中 const myData mock.bypass(() fs.readFileSync(/path/to/real/file.txt, utf-8));bypass同时支持同步、异步和 Promise 函数自动在函数执行完后恢复 mock实现见 lib/bypass.js。不过官方建议少用异步 bypass——如果其他代码在它完成前访问 mock 文件系统可能产生意外结果。与测试框架搭配beforeEach afterEach 是黄金组合配合 Mocha / Jest 的钩子每个用例都从干净的内存文件系统开始、结束即还原const mock require(mock-fs); beforeEach(function () { mock({ fake-file: file contents }); }); afterEach(mock.restore); // 测试跑完立刻还原真实 fs项目自带的集成测试就是标准示范在 test/integration/filecount.spec.js 中beforeEach搭建一个含多个文件和子目录的 mock 树afterEach(mock.restore)收尾被测试的业务代码 test/integration/filecount.js 全程只看见内存里的文件。同目录下还有 40 多个fs.*.spec.js单元测试覆盖了fs.readFile、fs.mkdir、fs.rename、fs.readlink等几乎全部常用 API可直接当mock-fs 支持了哪些接口的活文档查阅。避坑指南这些细节能帮你少走弯路⚠️务必还原调用mock()后记得在测试结束后调用mock.restore()某些场景如覆盖率工具 nyc下遗漏还原会引发连锁问题⚠️require 顺序mock-fs应在其他改造fs的模块如graceful-fs之前require注意它不兼容graceful-fs3.x4.x正常⚠️Jest 快照.toMatchSnapshot()会用fs读取已有快照mock 生效时 Jest 会静默通过新快照。安全做法是断言前手动mock.restore()可重复调用详见 readme.md 的 Using with Jest Snapshot Testing 一节⚠️权限判定在 POSIX 系统上mock 的文件访问控制依据文件mode及process.getuid()/getgid()Windows 上 mode 不生效⚠️版本演进mock-fs4 起改为覆盖process.binding(fs)fs.stat()返回的对象不再instanceof fs.Stats属性行为完全一致升级前可看 changelog.md源码结构速览想深入理解或二次开发时仓库目录职责一目了然路径职责lib/index.js入口打补丁、mock()/restore()总开关lib/binding.js模拟 Node 的 fs 原生绑定lib/filesystem.js内存文件树file/directory/symlink工厂lib/bypass.js真实文件系统旁路lib/loader.jsmock.load()真实资源导入benchmarks/mock 与真实fs的读写性能对比脚本运行npm test会以 mocha 递归执行test/下全部用例先跑 eslint想验证自己的环境可以直接试。总结mock-fs 用内存 mock 文件系统整体替换fs后端让你彻底告别磁盘 fixture 的创建与清理核心 API 只有四个mock(config)上盘、mock.restore()还原、mock.load()导真实文件、mock.bypass()临时摸真盘记住三句话先require它、用完就restore、路径统一用正斜杠从往磁盘上撒一把假文件到配置一个对象mock-fs 让文件测试变得和纯内存测试一样轻快。赞分享开发工具【免费下载链接】mock-fsConfigurable mock for the fs module项目地址https://gitcode.com/gh_mirrors/mo/mock-fs点击查看免费下载相关推荐长上下文处理新突破Ling-3.0-flash-int4如何轻松应对256K tokens输入长上下文处理新突破Ling 3.0 flash int4如何轻松应对256K tokens输入 Ling 3.0 flash int4是一款革命性的AI模型人工智能大模型推理模型基础模型awspec插件生态扩展测试能力的8个实用工具推荐awspec插件生态扩展测试能力的8个实用工具推荐 awspec是一款专为AWS资源打造的RSpec测试框架能够帮助开发者轻松编写和执行AWS资源的测试用例告别测试数据烦恼Vitest Fixture与Mock数据生成终极指南告别测试数据烦恼Vitest Fixture与Mock数据生成终极指南 在现代前端开发中测试是保证代码质量的关键环节但测试数据的管理常常成为开发者的痛点。测试开发工具质量保障代码覆盖率创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考