Project Icon

microdiff

轻量级、高性能的对象和数组比较工具

Microdiff是一个开源的JavaScript对象和数组比较工具,体积极小(不到1KB)、运行速度快、无依赖。它的性能远超大多数深度比较库,并提供完整的TypeScript支持。Microdiff支持多种平台,使用简便,能够处理Date和RegExp等复杂对象,并支持循环引用。对于需要在JavaScript项目中进行高效对象比较的开发者来说,Microdiff是一个理想的选择。

Microdiff标志

Microdiff是一个微小(目前<1kb)、快速、零依赖的对象和数组比较库。它比大多数其他深度比较库显著更快,并且完全支持TypeScript。

💡 我建议阅读这篇博文:

构建最快的对象和数组差异比较工具,了解Microdiff如何实现其体积和速度。

最小压缩大小(来自Bundlephobia) 许可证 依赖数量

特性

  • 🚀 速度是其他对象差异比较库的两倍以上
  • 📦 极其轻量,压缩后<1kb
  • 🌎 支持Deno、Node、网页,甚至服务工作线程。还附带内置的TypeScript类型
  • 🔰 使用非常简单,只有一个diff()函数
  • 📅 完全支持像new Date()new RegExp()这样的对象

开始使用

首先,安装Microdiff

npm i microdiff

如果你使用Deno,你可以从Deno.land导入,链接为https://deno.land/x/microdiff@VERSION/index.ts(记得将@VERSION更改为你想使用的版本)。

安装后,导入并在两个对象上运行它。

import diff from "microdiff";

const obj1 = {
	originalProperty: true,
};
const obj2 = {
	originalProperty: true,
	newProperty: "new",
};

console.log(diff(obj1, obj2));
// [{type: "CREATE", path: ["newProperty"], value: "new"}]

如果你使用CommonJS,可以这样导入:

const diff = require("microdiff").default;

有三种不同类型的变化:CREATEREMOVECHANGEpath属性给出了新对象中属性的路径(或在REMOVE情况下的旧对象)。 路径中的每个元素都是指向下一级属性的键,直到到达被更改的属性,它是一个字符串或数字,取决于对象是数组还是对象(带数字键的对象仍然是字符串)。 value属性存在于CREATECHANGE类型中,它包含添加/更改/删除的属性的值。 oldValue属性存在于CHANGEREMOVE类型中,它包含属性的旧值。

循环引用支持

默认情况下,Microdiff支持循环引用,但如果你确定对象没有循环,比如解析的JSON,你可以使用cyclesFix选项禁用循环检测。

diff(obj1, obj2, { cyclesFix: false });

基准测试

小对象基准测试
deep-diff: 17929ns - 慢409%
deep-object-diff: 10763ns - 慢206%
jsdiff: 79700ns - 慢2164%
microdiff: 3520ns - 最快

大对象基准测试
deep-diff: 272887ns - 慢259%
deep-object-diff: 160019ns - 慢111%
jsdiff: 1688294ns - 慢2123%
microdiff: 75934ns - 最快

这些基准测试目前只针对一个小对象和一个非常大的对象,所以可能不太准确。我将继续努力创建更多不同类型的基准测试。

贡献

感谢你帮助这个项目!贡献过程相当简单。首先fork仓库(如果你需要更多关于如何操作的信息,请查看这个GitHub指南),然后克隆到你的电脑上,开始编程!要编译程序,运行npm run build(如果你使用pnpm或yarn,请将npm替换为相应的命令)。这将在/dist目录下创建CommonJS和ESM模块。

要对microdiff进行基准测试,你可以运行npm run bench。这将自动构建Microdiff并运行一个基准测试程序,将microdiff与其他常见的差异比较库进行比较。

最后,Microdiff有一个广泛的测试套件,你应该充分利用它。要确保一切正常工作,你可以运行npm run testnpm run test会构建项目,然后在新版本上运行整个测试套件。如果你正在修复一个bug,请确保为它添加一个测试。 另外,在贡献之前,请确保阅读行为准则

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号