lazy.js 版本演进全记录:从 v0.1.0 到 v0.5.1 的功能变迁与实现原理

原创2026-10-14 14:07:491,445 阅读
文章标签:开发工具

lazy.js 版本演进全记录:从 v0.1.0 到 v0.5.1 的功能变迁与实现原理

<output_article>

lazy.js 版本演进全记录:从 v0.1.0 到 v0.5.1 的功能变迁与实现原理

lazy.js 是一个"像 Underscore 一样、但更懒"的 JavaScript 函数式工具库,其核心卖点是在链式调用 map、filter、take 等操作时不立即迭代、不创建中间数组,而是组装出一条惰性求值的 Sequence 链,直到调用 each(或 toArray)才开始真正消费数据。本文以仓库根目录的 CHANGES.md 为骨架,逐版本梳理 lazy.js 从 0.1.0 到 0.5.1 的功能演进,并结合 lazy.js 主文件源码与 spec/ 下的测试用例,讲清每个版本引入的能力、修复的缺陷及其底层实现。读完本文,你将理解 lazy.js 的版本脉络、关键 API 的用法,以及惰性引擎、异步迭代、UMD 模块化等设计在源码中的落点。

一、v0.1.x:起步与核心引擎雏形

v0.1.0:初始发布

v0.1.0 是 lazy.js 的初始版本,定义了整库的根基:以 Lazy(source) 包装数组、对象或字符串,得到相应的 ArrayLikeSequence、ObjectLikeSequence、StringLikeSequence,并在此基础上提供惰性 map/filter 等操作。这一架构至今仍保留在主文件开头的文档注释中:

  • 数组 → 由元素构成的 ArrayLikeSequence;
  • 对象 → 由键值对构成的 ObjectLikeSequence;
  • 字符串 → 由字符构成的 StringLikeSequence(见 lazy.js)。

从源码结构看,Sequence 是所有序列的公共基类,Iterator 对象(提供 moveNext 与 current)负责驱动惰性迭代(见 lazy.js)。任何自定义序列类型只需实现 getIterator 或 each 之一即可注册(见 lazy.js)。

v0.1.1:性能与可扩展性补强

v0.1.1 的主要变化集中在三方面:

  1. flatten 可以压平内层序列(不再只支持数组),例如 Lazy([1, Lazy([2, 3])]).flatten() 产出 [1, 2, 3];
  2. 新增 Sequence#toString;
  3. uniq、union、intersection、concat、zip 得到显著性能优化;
  4. 移除 Lazy.async,统一为 Sequence#async;
  5. 新增 Bower 与 Component 支持,并加入 Node 环境下的 Lazy.readFile 与 Lazy.makeHttpRequest。

flatten 至今保留"浅层/递归"两种模式(浅层选项在 v0.5.1 正式公开,见下文),其实现通过 eachShallow/eachRecursive 两条路径区分(见 lazy.js)。

二、v0.2.x:API 规范化与类型化序列爆发

v0.2.0 是一次大版本,为后续奠定了大量方法基础。

v0.2.0 的方法体系

字符串专属方法(StringLikeSequence):indexOf、lastIndexOf、contains(均接受子串)、startsWith、endsWith、reverse(返回 StringLikeSequence)、toUpperCase、toLowerCase、charCodeAt、substring。

数组专属方法(ArrayLikeSequence):pop、shift、slice(到 v0.4.3 又补上 push、unshift)。

通用控制流方法:takeWhile、dropWhile、consecutive——其中 consecutive(n) 将序列切分为长度为 n 的重叠片段,例如 Lazy(<a href="https://link.gitcode.com/i/34496d7c5f49d437e54c149fead1bdd8" target="_blank">1, 2, 3]).consecutive(2) 产出 [[1,2],[2,3]],空序列或不足长度的序列则产出空结果(见 [lazy.js)。其底层用 Queue 维护滑动窗口,每个元素进入队列后仅当队列满时才吐出一个片段(见 lazy.js)。注意:v0.5.1 修复了 consecutive() 返回值不可复用的问题,即同一 consecutive 序列可被多次迭代消费。

回调解耦:map、filter、sortBy、groupBy、countBy、any、all 支持传入"pluck 风格"的字符串回调(如 filter('lastName'));groupBy 与 countBy 改为返回 ObjectLikeSequence;min、max、sum 支持值选择器回调。

严格模式与工具函数:Lazy() 对 null/undefined 抛出错误(后被 v0.2.1 回退,改为返回空序列),并新增 Lazy.noop 与 Lazy.identity 便捷函数——两者在 lazy.js 中定义,被大量示例用作占位迭代器。

自定义序列定义:Sequence.define 的 init 不再强制要求接收 parent 作为首个参数(见 lazy.js),同时新增 ArrayLikeSequence.define、ObjectLikeSequence.define、StringLikeSequence.define,让用户能按类型扩展方法。

v0.2.1:回退与新增

v0.2.1 做了一次重要回退:Lazy() 对 null/undefined 不再抛错,而是返回空序列;严格行为则交给新增的 Lazy.strict()(见 lazy.js)。此外:

  • 新增 Lazy.parseJSON 方法,配套示例位于 experimental/lazy.json.js;
  • AsyncSequence#each 返回的 handle 支持 onComplete 回调。

三、v0.3.x:异步、事件与流处理

v0.3.x 是 lazy.js 能力范围急剧扩张的版本,把"惰性"从数组扩展到了异步任务、DOM 事件和 Node 流。

v0.3.0:AsyncHandle 与监视序列

v0.3.0 最重要的变化是:AsyncSequence 上的 reduce、min、max、sum、find、indexOf、contains、toArray、toObject、join/toString 这些"终结操作"现在返回promise 风格的 AsyncHandle,支持 onComplete(别名 then)在迭代完成后处理结果。这为异步惰性序列提供了统一的结果获取通道。

同版本还新增:

  • Lazy(object).watch:把对象属性的变更监控变成序列(见 lazy.js);
  • Sequence#chunk、Sequence#tap、Sequence#ofType;
  • 弃用 Lazy.events,改用 NodeSequence#on(作者在 changelog 中自注:NodeSequence 或许应改名为 DOMSequence)。

v0.3.1:尺寸、合并与流转换

  • 新增 Sequence#apply 与 Sequence#size(size 在 lazy.js 处有文档示例);
  • 新增 ObjectLikeSequence#merge;
  • 新增 Sequence#toStream:在 Node 中将序列转换为真正的 stream.Readable,便于与流式库协作。

v0.3.2:memoize 与包装器工厂

  • 新增 Sequence.createWrapper(按 Stack Overflow 上的经典问题 #20959394 设计),用于把任意事件源包装成序列;Lazy.createWrapper 的实现见 lazy.js;
  • 新增 Sequence#memoize 与 Sequence#none。memoize 会在首次迭代时缓存元素,使后续迭代访问到同一批对象——例如 Lazy.generate(createObject, 10).memoize().toArray()<a href="https://link.gitcode.com/i/9ab95a8bb994368707bd34ce0eed7776" target="_blank">0] === 再次调用 toArray()[0] 为 true(见 [lazy.js);
  • 修复 Sequence#reject 接受字符串或对象谓词;
  • 修复 Sequence#all 的缺陷;
  • AsyncSequence#getIterator 现在直接抛错(#63),避免对异步序列进行同步迭代。

v0.3.3(已弃用)

该版本标记为 abandoned,但其中的修复大多已并入后续版本:

  • Sequence#groupBy 支持异步序列;
  • StreamLikeSequence#split 能跨 chunk 正确切分;
  • Sequence#filter 改为向回调传入简单递增的索引(对齐 Underscore/Lo-Dash 行为);
  • 新增 Lazy.clone(对象/数组浅拷贝);
  • 新增 Sequence#sort,接受二元比较函数;sort/sortBy 均支持 descending 参数;
  • 新增 Sequence#indexBy。

四、v0.4.x:模块化、并发性与边界行为修复

v0.4.0:Promises/A+ 与通用 get

  • Lazy.AsyncHandle 实现 Promises/A+ 规范(#71),异步结果处理从此有了标准语义;
  • Sequence#get 推广到所有序列,而不再局限于 ArrayLikeSequence(#106)。不过需注意:对于非索引型序列,get(i) 可能需要部分求值才能走到目标下标,并非 O(1)(见 lazy.js);
  • ObjectLikeSequence#filter 返回 ObjectLikeSequence(#75),保持链式调用类型一致;
  • 修复 shuffle 总把第一个元素放到末尾(#113)、join 跳过空字符串(#115)、Lazy.range 偶尔少给一个值(#119)等问题。

v0.4.1(无记录)

Changelog 中没有 v0.4.1 的条目。

v0.4.2:UMD 与双端支持

  • 放弃 Node 0.8 支持;
  • Lazy 以 UMD 模块形式暴露:主文件入口采用"AMD/CommonJS/全局变量"三态分支,即 define.amd 存在时走 AMD、exports 存在时走 CommonJS、否则挂到 root.Lazy(见 lazy.js)。这也解释了仓库为何同时维护浏览器端 lazy.browser.js 与 Node 端 lazy.node.js 两个入口文件;
  • groupBy/indexBy 支持值变换函数(#97);
  • 修复有偏的 shuffle 实现(#142)、StringSegments 上无法调用 split(#123)、merge 对数组、日期及其他对象类型的处理(#154)。

v0.4.3:边界语义收尾

  • ArrayLikeSequence 新增 push、unshift(#173);
  • min/max 对空序列返回 undefined(#194),这是一个行为变更,测试中对应空数组场景;
  • zip 与 intersection 改为可交换(commutative)(#196、#197);
  • 修复对空数组 shuffle 返回 [undefined](#198);
  • join 支持非字符串分隔符(#193);
  • 修复 groupBy 完整迭代时缺少返回值(#179)、values().join 忽略分隔符(#184)、ObjectLikeSequence.keys 行为(#164)、DomEventSequence.each 不可用(#163)、get 对假值(falsey)元素的处理(#170)等问题;
  • 调整 ObjectLikeSequence.each 行为(#165)。

五、v0.5.x:ES6 时代与新公共 API

v0.5.0 让 lazy.js 拥抱 ES6,v0.5.1 则集中补强了可组合性 API。

v0.5.0:可迭代协议与原生集合支持

  • 序列支持 ES6 可迭代协议(#186):Sequence 通过 Symbol.iterator 暴露迭代器,可以用 for...of 直接遍历,或直接喂给 Array.from、展开运算符等 ES6 语法。从源码结构看,这与 getIterator/Iterator(moveNext/current)体系一脉相承(见 lazy.js);
  • 支持 ES6 Set 与 Map 对象:Lazy(set)/Lazy(map) 可直接包装并参与惰性链;
  • memoize().get 不再迭代整个序列(#191):此前为了 get 一个索引可能需要消费全序列,优化后只在必要时推进迭代器,配合 MemoizedSequence 的 memo 缓存与 iterator 游标实现(见 lazy.js);
  • 修复 defaults().defaults() 连续调用失败(#183)与 Lazy.readFile 设置编码的缺陷(#160)。

v0.5.1:可组合 API 补全

v0.5.1 是 changelog 记录的最新版本,新增内容全部可追溯到主文件源码:

1. 公共 equals()(#139)——Sequence.prototype.equals 通过双迭代器并行比对两个序列:长度不等直接返回 false,元素比较默认使用 Lazy.equality(即严格 ===,见 lazy.js),也支持传入自定义 equalityFn。注意它要求参数是 Sequence 实例,Lazy(<a href="https://link.gitcode.com/i/75d58d4f4dc04642ade51642a139a527" target="_blank">1,2]).equals([1,2]) 会返回 false;相关测试见 [spec/equals_spec.js。

2. Lazy.curry / Lazy.curryRight(#24)——curry 实现 依据函数形参数 arity 收集参数,curried(1)(2)(3)、curried(1,2)(3) 等写法均等价;curryRight(实现)则从右侧收集,curriedRight(3)(2)(1) 最终得到 [1, 2, 3]。两者都可与 map 组合实现参数预填。

3. Lazy.createCallback / Lazy.createComparator(#140)——createCallback 统一了 Lo-Dash 风格的回调形态:函数原样返回;字符串转成"pluck 风格"(e<a href="https://link.gitcode.com/i/92608d74c4d05f0386581aaa3d366a3b" target="_blank">key]);对象转成"where 风格"(全部键值匹配才返回 true);undefined 时返回默认值回调或 Lazy.identity;其他类型直接抛错。createComparator([实现)基于它把"取值函数"升级为"比较函数",返回 1/-1/0,可喂给 sortBy/sort 等排序方法。

4. flatten() 的 shallow 选项(#125)——flatten(true) 只压平一层:Lazy(<a href="https://link.gitcode.com/i/f61466d29e4e7a486e8189a96de64598" target="_blank">1, [2, 3], [4, [5]]]).flatten(true) 得到 [1, 2, 3, 4, [5]],而不带参数时递归压平到 [1, 2, 3, 4, 5](见 [lazy.js)。

5. indexOf/lastIndexOf/contains 支持 equalityFn 参数——三者均默认使用 Lazy.equality(严格相等),传入自定义相等函数即可实现不区分大小写等场景(见 lazy.js、lazy.js)。

6. 两处缺陷修复:

  • consecutive() 返回值不可复用(#212):修复后同一 consecutive 序列可安全多次消费(测试覆盖见 spec/concat_spec.js 附近的迭代复用场景,文档示例见 lazy.js);
  • concat() 意外压平结果(#127):concat 拼接的是序列/数组本身,不再递归压平内层元素(flatten 中"可压平内层序列"的示例见 lazy.js)。

六、版本脉络小结与工程启示

版本 主题 代表性能力
v0.1.0 初始发布 Lazy() 包装数组/对象/字符串,惰性 Sequence
v0.1.1 性能与扩展 flatten 内层序列、toString、Bower/Component、readFile/makeHttpRequest
v0.2.0 API 规范化 takeWhile/dropWhile/consecutive、字符串/数组专属方法、pluck 风格回调、Sequence.define 族
v0.2.1 行为回退 Lazy.strict()、Lazy.parseJSON、onComplete
v0.3.0 异步与事件 AsyncHandle(promise 风格)、watch、chunk/tap/ofType
v0.3.1 流处理 apply/size/merge/toStream
v0.3.2 记忆化 createWrapper、memoize/none
v0.4.0 标准异步 AsyncHandle 实现 Promises/A+、通用 get
v0.4.2 模块化 UMD 暴露、放弃 Node 0.8、groupBy/indexBy 值变换
v0.4.3 边界语义 push/unshift、空序列 min/max 返回 undefined、可交换的 zip/intersection
v0.5.0 ES6 时代 可迭代协议、Set/Map 支持、memoize().get 优化
v0.5.1 组合能力 equals、curry/curryRight、createCallback/createComparator、flatten(shallow)、equalityFn

从 CHANGES.md 可以清楚看到 lazy.js 的演进主线:先立惰性迭代核心,再补齐类型化方法与回调形态,随后扩展异步/事件/流能力,最终在 ES6 时代标准化可迭代接口并沉淀可组合工具函数。如果你想深入某个能力,建议按以下路径对照阅读:

结合 spec/ 下 equals_spec.js、concat_spec.js 等测试文件,你还可以验证这些版本声明在实际行为上的落点。需要注意的是,README 在文末标注"该库仍处于实验性与持续改进中",部分 API(如流处理辅助方法)也注明了"可能变更",实际使用时请以当前仓库 lazy.js 与 lazy.browser.js/lazy.node.js 的暴露接口为准。 </output_article>

登录后查看全文
lazy.js