RxJS 4groupByUntil操作符完全指南为可观察分组注入生命周期管理【免费下载链接】RxJSThe Reactive Extensions for JavaScript项目地址: https://gitcode.com/gh_mirrors/rxj/RxJSgroupByUntil是 RxJS 4Reactive Extensions for JavaScript中用于动态分组的核心操作符它按照keySelector提取的键把上游可观察序列拆分成多个组可观察序列GroupedObservable并且每个组都拥有由durationSelector定义的独立生命周期——组到期即完成同键元素再次出现时组会重生。本文将以 doc/api/core/operators/groupbyuntil.md 为骨架结合仓库源码 src/core/linq/observable/groupbyuntil.js、src/core/linq/groupedobservable.js 以及完整测试套件 tests/observable/groupbyuntil.js带你掌握该操作符的签名、运行机制、边界行为与实际用法。一、操作符定位groupBy 的有界版本在 RxJS 4 中groupByUntil与groupBy同属于分组Grouping家族但二者有一个关键差异groupBy的分组一旦创建就永久存活而groupByUntil允许每个分组到期自动完成。这一点在源码中有直接体现——src/core/linq/observable/groupby.js 中的groupBy实现只是groupByUntil的特例observableProto.groupBy function (keySelector, elementSelector) { return this.groupByUntil(keySelector, elementSelector, observableNever); };也就是说groupBy等价于传入一个永不结束的durationSelectorobservableNever因此分组永远不因时间到期而回收。而groupByUntil通过第三个参数把分组的存活时长变成了一等公民适合会话跟踪、按键连击统计、突发流量聚合等需要分组过期回收的场景。二、方法签名与参数说明Rx.Observable.prototype.groupByUntil(keySelector, [elementSelector], durationSelector)依据 ts/core/linq/observable/groupbyuntil.ts 中的 TypeScript 重载声明方法同时支持跳过元素选择与元素映射两种形态参数类型必填说明keySelectorFunction是从每个源元素中提取分组键的函数如function (x) { return x.keyCode; }。相同键的元素归入同一个组elementSelectorFunction否把每个源元素映射为组内元素的函数如function (x) { return x.keyCode; }。省略时组内元素就是源元素本身durationSelectorFunction是接收刚创建的组GroupedObservable返回一个用于宣告该组到期的可观察序列。该序列发出第一个元素或完成后对应分组即完成并被回收keySerializerFunction否TS 声明中有在 TypeScript 声明中可见的可选参数用于序列化复杂键对象/数组以作为 Map 键使用JS 运行时版本中未显式使用返回Observable—— 一个由组可观察序列构成的外层序列。每个GroupedObservable对应一个唯一键值内部包含所有共享该键的元素。生命周期语义原文档核心说明如果某个组的生命周期到期那么当再次出现同键元素时系统会重新创建一个拥有全新生命周期的新组。这意味着同一键值可以在时间轴上多次出生-死亡-重生。三、完整示例按键序列分组统计原文档给出的示例模拟了经典的魂斗罗秘籍Konami Code按键流每 1000ms 发出一个按键durationSelector设定分组存活 2000ms因此每次连续快速输入的相同按键会被统计为一批var codes [ { keyCode: 38}, // up { keyCode: 38}, // up { keyCode: 40}, // down { keyCode: 40}, // down { keyCode: 37}, // left { keyCode: 39}, // right { keyCode: 37}, // left { keyCode: 39}, // right { keyCode: 66}, // b { keyCode: 65} // a ]; var source Rx.Observable .for(codes, function (x) { return Rx.Observable.return(x).delay(1000); }) .groupByUntil( function (x) { return x.keyCode; }, function (x) { return x.keyCode; }, function (x) { return Rx.Observable.timer(2000); }); var subscription source.subscribe( function (obs) { // Print the count obs.count().subscribe(function (x) { console.log(Count: x); }); }, function (err) { console.log(Error: err); }, function () { console.log(Completed); }); // Count: 2 // Count: 2 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Completed输出解读38上连续两次出现且间隔 1000ms 2000ms归入同一组 →Count: 240下同理 →Count: 2其余每个按键37、39、66、65在各自 2000ms 窗口内只出现一次且与前一个按键间隔 1000ms 后即到达上一组的存活边界故各自独立成组 → 各Count: 1。外层source.subscribe的onNext收到的是内层分组对象obs你可以像订阅普通可观察序列一样对它调用count()、map()等操作符——这正是GroupedObservable的价值组内元素仍然可以继续被组合操作符处理。四、源码级原理Map、Subject 与引用计数的协同要真正理解groupByUntil需要阅读它的核心实现 src/core/linq/observable/groupbyuntil.js。整个实现建立在一个Map、一个Subject池和引用计数之上4.1 数据结构return new AnonymousObservable(function (o) { var map new Map(), groupDisposable new CompositeDisposable(), refCountDisposable new RefCountDisposable(groupDisposable), handleError function (e) { return function (item) { item.onError(e); }; }; ... return refCountDisposable; }, source);map键 →Subject的映射。每个活跃分组背后都是一个Subject源元素经处理后写入该SubjectgroupDisposable/refCountDisposable所有内层订阅包括时长订阅都被纳入一个CompositeDisposable再用RefCountDisposable包装实现所有内部订阅释放后外层订阅才真正释放的引用计数语义handleError工具函数把错误广播给当前所有活跃分组。4.2 每个源元素的处理流水线var key tryCatch(keySelector)(x); if (key errorObj) { map.forEach(handleError(key.e)); return o.onError(key.e); } var fireNewMapEntry false, writer map.get(key); if (writer undefined) { writer new Subject(); map.set(key, writer); fireNewMapEntry true; }先用tryCatch包裹keySelector——键选择器抛错时错误会同时传给所有现存分组与外层观察者查map键不存在则新建Subject并登记标记fireNewMapEntry true表示这是新组。4.3 新组的诞生与时长注册if (fireNewMapEntry) { var group new GroupedObservable(key, writer, refCountDisposable), durationGroup new GroupedObservable(key, writer); var duration tryCatch(durationSelector)(durationGroup); if (duration errorObj) { /* 广播并报错 */ } o.onNext(group); var md new SingleAssignmentDisposable(); groupDisposable.add(md); md.setDisposable(duration.take(1).subscribe( noop, function (e) { /* 广播错误 */ }, function () { if (mapdelete) { writer.onCompleted(); } groupDisposable.remove(md); })); }值得注意的细节durationSelector收到的是durationGroup同一个Subject的第二个GroupedObservable视图因此你完全可以在时长函数里观察这个组自身的元素来决定何时让它过期例如function (g) { return g.skip(2); }时长序列用.take(1)截断第一个元素或完成信号都会触发到期到期回调执行mapdelete并从groupDisposable中移除该时长订阅——键被回收后后续同键元素将触发重生流程。4.4 元素写入与终止传播var element x; if (isFunction(elementSelector)) { element tryCatch(elementSelector)(x); /* 抛错则广播 */ } writer.onNext(element);elementSelector同样以tryCatch保护元素最终写入writer即该组的Subject。外层终止时源onError(e)→ 所有活跃分组onError外层onError源onCompleted()→ 所有活跃分组onCompleted外层onCompleted。4.5 GroupedObservable 的封装src/core/linq/groupedobservable.js 定义了GroupedObservable它持有key属性并通过UnderlyingObservable把refCountDisposable与内层Subject的订阅绑定在一起——订阅组时自动登记到引用计数group.key可以直接读取该分组的键值。五、行为边界来自测试套件的验证仓库为groupByUntil提供了 19 个 QUnit 用例tests/observable/groupbyuntil.js系统性地验证了各种边界行为。这些用例使用TestScheduler与ReactiveTest.onNext/onError/onCompleted精确断言虚拟时间线上的事件是理解语义的活文档测试名称验证的行为GroupByUntil WithKeyComparer/Default键选择器对元素做toLowerCase().trim()归一化foo键在 220 与 470 两次出现因g.skip(2)触发到期而产生两个组外层输出foo, bar, baz, qux, fooOuter Complete源完成时570ms外层完成所有键选择/元素选择函数各调用 12 次Outer Error源在第 570ms 报错外层onError订阅在 570ms 释放Outer Dispose外层在 355ms 释放时订阅整体终止键/元素选择器各只调用 5 次Outer KeyThrow/EleThrowkeySelector或elementSelector第 10 次调用抛错时错误立即传播到外层与所有活跃分组Inner Complete组因g.skip(2)到期后收到onCompletedbar组在 420ms 完成、baz组在 510ms 完成Inner Error/KeyThrow/EleThrow内层错误传播未完成的qux、foo组收到onErrorInner Dispose/Multiple Independence内外层独立性释放单个内层订阅不影响外层和其他组外层先释放时内层组仍可能继续接收Inner Escape Complete / Error / Dispose分组对象逃逸到订阅之外再订阅组仍能回放完成/错误信号且外层释放后内层不再有输出DurationSelector ThrowsdurationSelector抛错时外层立即onError210ms这些用例印证了两个关键结论组到期是每键独立的每个分组都有自己的时长订阅map[delete]只回收当前键同键重生是真实存在的foo键在 220ms 与 470ms 各自成组说明第一组到期后第二组以全新生命周期诞生。六、典型应用场景与使用建议结合上述语义groupByUntil适合以下场景突发流量/事件窗口聚合按用户 ID 分组durationSelector返回Rx.Observable.timer(5000)实现5 秒无该用户请求即关闭该用户的组按键连击检测如示例中的游戏秘籍识别用timer设定组合键的超时窗口会话跟踪以会话 ID 为键会话超时timer后组自动完成配合count()、reduce()汇总会话内事件动态窗口基于元素的过期durationSelector可返回g.skip(2)这类组内出现第 N 个元素即到期的序列实现元素数量驱动的分组回收这正是测试套件反复使用的模式。使用时的几个实践要点必须订阅内层组外层只负责派发组对象组内数据需要你对外层onNext收到的每个obs再次subscribe或组合count()等操作符否则元素不会产生副作用durationSelector的返回值要有尽头若传入Rx.Observable.never()分组永远不会过期行为退化为groupBy错误处理三处都要留意keySelector、elementSelector、durationSelector任何一个抛错错误都会被广播给所有活跃分组并终止外层注意引用计数的资源释放实现通过RefCountDisposable管理内部订阅所有内层订阅释放后外层订阅才会真正释放因此不再使用的内层订阅应及时dispose()避免资源滞留。七、文件位置与版本说明API 文档doc/api/core/operators/groupbyuntil.md核心实现src/core/linq/observable/groupbyuntil.js组类型定义src/core/linq/groupedobservable.jsTypeScript 声明ts/core/linq/observable/groupbyuntil.ts单元测试tests/observable/groupbyuntil.js关联操作符src/core/linq/observable/groupby.jsgroupBy是groupByUntil永不过期时的特例该操作符随rx的完整发行版对应本仓库nuget/下的 RxJS-All.nuspec以及 coincidence 系列发行版RxJS-Coincidence.nuspec发布模块化构建中对应modules/rx-lite-coincidence/目录。本文所述均为 RxJS 4 的行为与 RxJS 5 的 API 存在差异使用时请以当前仓库对应的版本为准。【免费下载链接】RxJSThe Reactive Extensions for JavaScript项目地址: https://gitcode.com/gh_mirrors/rxj/RxJS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
RxJS 4groupByUntil操作符完全指南为可观察分组注入生命周期管理【免费下载链接】RxJSThe Reactive Extensions for JavaScript项目地址: https://gitcode.com/gh_mirrors/rxj/RxJSgroupByUntil是 RxJS 4Reactive Extensions for JavaScript中用于动态分组的核心操作符它按照keySelector提取的键把上游可观察序列拆分成多个组可观察序列GroupedObservable并且每个组都拥有由durationSelector定义的独立生命周期——组到期即完成同键元素再次出现时组会重生。本文将以 doc/api/core/operators/groupbyuntil.md 为骨架结合仓库源码 src/core/linq/observable/groupbyuntil.js、src/core/linq/groupedobservable.js 以及完整测试套件 tests/observable/groupbyuntil.js带你掌握该操作符的签名、运行机制、边界行为与实际用法。一、操作符定位groupBy 的有界版本在 RxJS 4 中groupByUntil与groupBy同属于分组Grouping家族但二者有一个关键差异groupBy的分组一旦创建就永久存活而groupByUntil允许每个分组到期自动完成。这一点在源码中有直接体现——src/core/linq/observable/groupby.js 中的groupBy实现只是groupByUntil的特例observableProto.groupBy function (keySelector, elementSelector) { return this.groupByUntil(keySelector, elementSelector, observableNever); };也就是说groupBy等价于传入一个永不结束的durationSelectorobservableNever因此分组永远不因时间到期而回收。而groupByUntil通过第三个参数把分组的存活时长变成了一等公民适合会话跟踪、按键连击统计、突发流量聚合等需要分组过期回收的场景。二、方法签名与参数说明Rx.Observable.prototype.groupByUntil(keySelector, [elementSelector], durationSelector)依据 ts/core/linq/observable/groupbyuntil.ts 中的 TypeScript 重载声明方法同时支持跳过元素选择与元素映射两种形态参数类型必填说明keySelectorFunction是从每个源元素中提取分组键的函数如function (x) { return x.keyCode; }。相同键的元素归入同一个组elementSelectorFunction否把每个源元素映射为组内元素的函数如function (x) { return x.keyCode; }。省略时组内元素就是源元素本身durationSelectorFunction是接收刚创建的组GroupedObservable返回一个用于宣告该组到期的可观察序列。该序列发出第一个元素或完成后对应分组即完成并被回收keySerializerFunction否TS 声明中有在 TypeScript 声明中可见的可选参数用于序列化复杂键对象/数组以作为 Map 键使用JS 运行时版本中未显式使用返回Observable—— 一个由组可观察序列构成的外层序列。每个GroupedObservable对应一个唯一键值内部包含所有共享该键的元素。生命周期语义原文档核心说明如果某个组的生命周期到期那么当再次出现同键元素时系统会重新创建一个拥有全新生命周期的新组。这意味着同一键值可以在时间轴上多次出生-死亡-重生。三、完整示例按键序列分组统计原文档给出的示例模拟了经典的魂斗罗秘籍Konami Code按键流每 1000ms 发出一个按键durationSelector设定分组存活 2000ms因此每次连续快速输入的相同按键会被统计为一批var codes [ { keyCode: 38}, // up { keyCode: 38}, // up { keyCode: 40}, // down { keyCode: 40}, // down { keyCode: 37}, // left { keyCode: 39}, // right { keyCode: 37}, // left { keyCode: 39}, // right { keyCode: 66}, // b { keyCode: 65} // a ]; var source Rx.Observable .for(codes, function (x) { return Rx.Observable.return(x).delay(1000); }) .groupByUntil( function (x) { return x.keyCode; }, function (x) { return x.keyCode; }, function (x) { return Rx.Observable.timer(2000); }); var subscription source.subscribe( function (obs) { // Print the count obs.count().subscribe(function (x) { console.log(Count: x); }); }, function (err) { console.log(Error: err); }, function () { console.log(Completed); }); // Count: 2 // Count: 2 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Count: 1 // Completed输出解读38上连续两次出现且间隔 1000ms 2000ms归入同一组 →Count: 240下同理 →Count: 2其余每个按键37、39、66、65在各自 2000ms 窗口内只出现一次且与前一个按键间隔 1000ms 后即到达上一组的存活边界故各自独立成组 → 各Count: 1。外层source.subscribe的onNext收到的是内层分组对象obs你可以像订阅普通可观察序列一样对它调用count()、map()等操作符——这正是GroupedObservable的价值组内元素仍然可以继续被组合操作符处理。四、源码级原理Map、Subject 与引用计数的协同要真正理解groupByUntil需要阅读它的核心实现 src/core/linq/observable/groupbyuntil.js。整个实现建立在一个Map、一个Subject池和引用计数之上4.1 数据结构return new AnonymousObservable(function (o) { var map new Map(), groupDisposable new CompositeDisposable(), refCountDisposable new RefCountDisposable(groupDisposable), handleError function (e) { return function (item) { item.onError(e); }; }; ... return refCountDisposable; }, source);map键 →Subject的映射。每个活跃分组背后都是一个Subject源元素经处理后写入该SubjectgroupDisposable/refCountDisposable所有内层订阅包括时长订阅都被纳入一个CompositeDisposable再用RefCountDisposable包装实现所有内部订阅释放后外层订阅才真正释放的引用计数语义handleError工具函数把错误广播给当前所有活跃分组。4.2 每个源元素的处理流水线var key tryCatch(keySelector)(x); if (key errorObj) { map.forEach(handleError(key.e)); return o.onError(key.e); } var fireNewMapEntry false, writer map.get(key); if (writer undefined) { writer new Subject(); map.set(key, writer); fireNewMapEntry true; }先用tryCatch包裹keySelector——键选择器抛错时错误会同时传给所有现存分组与外层观察者查map键不存在则新建Subject并登记标记fireNewMapEntry true表示这是新组。4.3 新组的诞生与时长注册if (fireNewMapEntry) { var group new GroupedObservable(key, writer, refCountDisposable), durationGroup new GroupedObservable(key, writer); var duration tryCatch(durationSelector)(durationGroup); if (duration errorObj) { /* 广播并报错 */ } o.onNext(group); var md new SingleAssignmentDisposable(); groupDisposable.add(md); md.setDisposable(duration.take(1).subscribe( noop, function (e) { /* 广播错误 */ }, function () { if (mapdelete) { writer.onCompleted(); } groupDisposable.remove(md); })); }值得注意的细节durationSelector收到的是durationGroup同一个Subject的第二个GroupedObservable视图因此你完全可以在时长函数里观察这个组自身的元素来决定何时让它过期例如function (g) { return g.skip(2); }时长序列用.take(1)截断第一个元素或完成信号都会触发到期到期回调执行mapdelete并从groupDisposable中移除该时长订阅——键被回收后后续同键元素将触发重生流程。4.4 元素写入与终止传播var element x; if (isFunction(elementSelector)) { element tryCatch(elementSelector)(x); /* 抛错则广播 */ } writer.onNext(element);elementSelector同样以tryCatch保护元素最终写入writer即该组的Subject。外层终止时源onError(e)→ 所有活跃分组onError外层onError源onCompleted()→ 所有活跃分组onCompleted外层onCompleted。4.5 GroupedObservable 的封装src/core/linq/groupedobservable.js 定义了GroupedObservable它持有key属性并通过UnderlyingObservable把refCountDisposable与内层Subject的订阅绑定在一起——订阅组时自动登记到引用计数group.key可以直接读取该分组的键值。五、行为边界来自测试套件的验证仓库为groupByUntil提供了 19 个 QUnit 用例tests/observable/groupbyuntil.js系统性地验证了各种边界行为。这些用例使用TestScheduler与ReactiveTest.onNext/onError/onCompleted精确断言虚拟时间线上的事件是理解语义的活文档测试名称验证的行为GroupByUntil WithKeyComparer/Default键选择器对元素做toLowerCase().trim()归一化foo键在 220 与 470 两次出现因g.skip(2)触发到期而产生两个组外层输出foo, bar, baz, qux, fooOuter Complete源完成时570ms外层完成所有键选择/元素选择函数各调用 12 次Outer Error源在第 570ms 报错外层onError订阅在 570ms 释放Outer Dispose外层在 355ms 释放时订阅整体终止键/元素选择器各只调用 5 次Outer KeyThrow/EleThrowkeySelector或elementSelector第 10 次调用抛错时错误立即传播到外层与所有活跃分组Inner Complete组因g.skip(2)到期后收到onCompletedbar组在 420ms 完成、baz组在 510ms 完成Inner Error/KeyThrow/EleThrow内层错误传播未完成的qux、foo组收到onErrorInner Dispose/Multiple Independence内外层独立性释放单个内层订阅不影响外层和其他组外层先释放时内层组仍可能继续接收Inner Escape Complete / Error / Dispose分组对象逃逸到订阅之外再订阅组仍能回放完成/错误信号且外层释放后内层不再有输出DurationSelector ThrowsdurationSelector抛错时外层立即onError210ms这些用例印证了两个关键结论组到期是每键独立的每个分组都有自己的时长订阅map[delete]只回收当前键同键重生是真实存在的foo键在 220ms 与 470ms 各自成组说明第一组到期后第二组以全新生命周期诞生。六、典型应用场景与使用建议结合上述语义groupByUntil适合以下场景突发流量/事件窗口聚合按用户 ID 分组durationSelector返回Rx.Observable.timer(5000)实现5 秒无该用户请求即关闭该用户的组按键连击检测如示例中的游戏秘籍识别用timer设定组合键的超时窗口会话跟踪以会话 ID 为键会话超时timer后组自动完成配合count()、reduce()汇总会话内事件动态窗口基于元素的过期durationSelector可返回g.skip(2)这类组内出现第 N 个元素即到期的序列实现元素数量驱动的分组回收这正是测试套件反复使用的模式。使用时的几个实践要点必须订阅内层组外层只负责派发组对象组内数据需要你对外层onNext收到的每个obs再次subscribe或组合count()等操作符否则元素不会产生副作用durationSelector的返回值要有尽头若传入Rx.Observable.never()分组永远不会过期行为退化为groupBy错误处理三处都要留意keySelector、elementSelector、durationSelector任何一个抛错错误都会被广播给所有活跃分组并终止外层注意引用计数的资源释放实现通过RefCountDisposable管理内部订阅所有内层订阅释放后外层订阅才会真正释放因此不再使用的内层订阅应及时dispose()避免资源滞留。七、文件位置与版本说明API 文档doc/api/core/operators/groupbyuntil.md核心实现src/core/linq/observable/groupbyuntil.js组类型定义src/core/linq/groupedobservable.jsTypeScript 声明ts/core/linq/observable/groupbyuntil.ts单元测试tests/observable/groupbyuntil.js关联操作符src/core/linq/observable/groupby.jsgroupBy是groupByUntil永不过期时的特例该操作符随rx的完整发行版对应本仓库nuget/下的 RxJS-All.nuspec以及 coincidence 系列发行版RxJS-Coincidence.nuspec发布模块化构建中对应modules/rx-lite-coincidence/目录。本文所述均为 RxJS 4 的行为与 RxJS 5 的 API 存在差异使用时请以当前仓库对应的版本为准。【免费下载链接】RxJSThe Reactive Extensions for JavaScript项目地址: https://gitcode.com/gh_mirrors/rxj/RxJS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
