iterator chunking S3

中文标题：迭代器分块

提案概览

阶段: Stage 3
状态: 进行中
ECMAScript 版本: —
同步时间: 2026年8月26日
English original · 官方仓库

提案速览

该提案为迭代器添加了 chunks() 和 windows() 方法，用于按给定大小消费非重叠和重叠的子序列。它涵盖了广泛的使用场景，如分页、批处理和滑动窗口计算。

Note

以下 README 来自上游仓库，其中的阶段或状态标注可能滞后；当前信息以提案概览为准。

迭代器分块

一个 TC39 提案，用于将迭代器按可配置的大小消费为重叠或非重叠的子序列。

阶段： 3。进一步推进取决于 2 个或更多已实现的实现。

规范： https://tc39.es/proposal-iterator-chunking/

向委员会提交的演示

动机

有时需要一次消费一个流中的多个值。例如，某些算法需要查看相邻元素。

分块

对于非重叠子序列，通常通过“分块”方法解决，其工作方式如下：

const digits = () => [0, 1, 2, 3, 4, 5, 6, 7, 8, 9].values();

let chunksOf2 = Array.from(digits().chunks(2));
// [ [0, 1], [2, 3], [4, 5], [6, 7], [8, 9] ]

let chunksOf3 = Array.from(digits().chunks(3));
// [ [0, 1, 2], [3, 4, 5], [6, 7, 8], [9] ]

let chunksOf4 = Array.from(digits().chunks(4));
// [ [0, 1, 2, 3], [4, 5, 6, 7], [8, 9] ]

分块的用例

分页
列式/网格布局，如日历
批量/流式处理
矩阵运算
格式化/编码
分桶（使用计算的分块大小，适用于已知大小的迭代器）

滑动窗口

当需要重叠序列时，这通常被称为“滑动窗口”。

let windowsOf2 = Array.from(digits().windows(2));
// [ [0, 1], [1, 2], [2, 3], [3, 4], [4, 5], [5, 6], [6, 7], [7, 8], [8, 9] ]

let windowsOf3 = Array.from(digits().windows(3));
// [ [0, 1, 2], [1, 2, 3], [2, 3, 4], [3, 4, 5], [4, 5, 6], [5, 6, 7], [6, 7, 8], [7, 8, 9] ]

let windowsOf4 = Array.from(digits().windows(4));
// [ [0, 1, 2, 3], [1, 2, 3, 4], [2, 3, 4, 5], [3, 4, 5, 6], [4, 5, 6, 7], [5, 6, 7, 8], [6, 7, 8, 9] ]

滑动窗口的用例

运行/连续计算，如平均值
上下文敏感算法，如成对比较
轮播及其类似物（当应用于无限循环时）

先例

其他语言

语言	库	chunks	windows	大小为0的chunks？	截断windows？
C++	std::ranges::views	`chunk`	`slide`	未定义行为	否
Clojure	core	`partition`	`partition`	无限空列表	当填充不足时；在1之后终止
Elm	List.Extra	`groupsOf`	`groupsOfWithStep`	空列表	否
Haskell	split	`chunksOf`	`divvy`	无限空列表	是
Java	Stream	`Gatherers.windowFixed`	`Gatherers.windowSliding`	抛出异常	否，步长不可配置
Kotlin	Iterable	`chunked`	`windowed`	抛出异常	可通过参数配置
.NET	System.Linq	`Enumerable.Chunk`	--	抛出异常	不适用
PHP	array	`array_chunk`	--	抛出异常	不适用
Python	itertools (3.12)	`batched`	--	??	不适用
Python	more-itertools	`grouper`	`windowed`	空迭代器	否，强制填充值
Ruby	Enumerable	`each_slice`	`each_cons`	抛出异常	否，步长不可配置
Rust	Iterator	`array_chunks`	`map_windows`	恐慌	否，步长不可配置
Rust	slice	`chunks`	`windows`	恐慌	否，步长不可配置
Scala	Seq	`grouped`	`sliding`	抛出异常	是
Swift	Sequence	--	--	不适用	不适用

JS库

库	chunks	windows	大小为0的chunks？	截断windows？
`chunk`	`chunk`	--	将0强制转换为false 😞	不适用
`extra-iterable`	`chunk`	`chunk`	无限空数组	是
`iter-ops`	`page`	--	抛出异常	不适用
`iter-tools`	`batch`	`window`, `windowAhead`, `windowBehind`	抛出异常	可选
`iterablefu`	`chunk`	--	将所有内容收集到单个数组	不适用
`itertools-ts`	`chunkwise`	`chunkwiseOverlap`	抛出异常	是
Lodash / Underscore	`chunk`	--	无限空数组	不适用
Ramda	`splitEvery`	`aperture`	无限空数组	否
sequency	`chunk`	--	抛出异常	不适用
wu	`chunk`	--	将所有内容收集到单个数组	不适用

#iterator chunking S3

#迭代器分块

#向委员会提交的演示

#动机

#分块

#分块的用例

#滑动窗口

#滑动窗口的用例

#先例

#其他语言

#JS库