@harperfast/extended-iterable

中文文档
1.0.5发布于 2026/10/21Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 1758.3万

扩展可执行类, 提供懒惰的类似阵列的方法, 配备自动合成和返回/ 推移转发

中文使用文档
文档目录3 节
  1. 重排中抓取错误
  2. 许可证
  3. 相关项目

license npm version npm downloads

扩展可插入软件包提供了一个执行可移动/异构协议的类,并提供类似数组的方法 有懒惰评价,类似于 执行者助手然而, 可扩展性提供了额外的方法,能够同时处理同步和同步迭代,自动处理 同步召回,并返回/移动转发,在使用时对适当的清理至关重要 数据库交易.

软件包导出一个 ExtendedIterable 类,可以以基本耐用方式构建或可以构建 毫无辩驳,而且加以配给 iterate 方法,以返回延时器.

例如,我们可以创建 ExtendedIterable数字 :

import { ExtendedIterable } from '@harperdb/extended-iterable';

function performQuery() {
    let results = new ExtendedIterable();
    results.iterate = function() {
        let txn = startTxn(); // we can start a transaction in some database, and be notified of when the iterable is completed below
        let cursor = txn.doQuery();
        return {
            // implement an iterator
            next() {
                // iterate through a query or table
                let entry = cursor.getNext();
                if (entry)
                    return { value: entry };
                else
                    return { done: true };
            },
            return () { // called when the iterator is done
                txn.commit();
            },
            throw () {
                txn.abort();
            }
        }
    };
    return results;
}

回来的 ExtendedIterable 完全可执行 :

let extendedIterable = performQuery();
for (let value of extendedIterable) {
    // for each value
}

或者我们可以在返回的结果上使用所提供的迭接方法:

extendedIterable
    .filter((value) => test(value))
    .forEach((value) => {
        // for each value that matched the filter
    })

请注意: map 财务报告和审定财务报表 filter 也懒惰,他们只会被处死 只有在他们返回的 累赘或 forEach 它被召唤。 这个 map 财务报告和审定财务报表 filter 函数还支持基于async/promise的函数,如果调用函数同步执行(返回承诺),则可以创建async stractionable.

我们还可以通过偏移查询以跳过一定数量的条目,并通过下列方式限制条目的数量:

let sliced = extendedIterable.slice(10, 20); // skip first 10 and get next 10

如果您想要从结果中获得一个真实的数组 asArray 属性将作为数组返回结果.

重排中抓取错误

在一个阵列, map 财务报告和审定财务报表 filter 调用符立即被执行,但智能调用符则在调用符时被执行,因此如果调用符时发生错误,在尝试调用符时会抛出错误. 同样关键的是,当一个迭代完成后,光标会被关闭,因此默认情况下,如果迭代过程中发生出错,光标会被立即关闭. 然而,如果你想抓住在 map (和 flatMap(重复时的回调,你可以使用 mapError 方法来捕捉重复过程中发生的错误,并允许重复继续(不关闭光标)。 例如:

let mapped = extendedIterable.map(({ key, value }) => {
    return thisMightThrowError(value);
}).mapError((error) => {
    // rather than letting the error terminate the iteration, we can catch it here and return a value to continue iterating:
    return 'error occurred';
})
for (let entry of mapped) {
...
}

A 类 mapError callback 可以返回一个值来继续重复,或者扔出一个错误来终止重复.

许可证

这个图书馆根据麻省理工学院许可证的规定获得许可.

版本与发布记录

@harperfast/extended-iterable 共发布 5 个版本,首次发布于 2025/12/18;过去 12 个月发布了 5 个版本。

版本发布日期距今
1.0.5latest2026/10/2127 天前
1.0.42026/10/2028 天前
1.0.32026/01/249 个月前
1.0.22026/01/249 个月前
1.0.12025/12/1810 个月前

关于 @harperfast/extended-iterable 的常见问题

@harperfast/extended-iterable 是什么?

扩展可执行类, 提供懒惰的类似阵列的方法, 配备自动合成和返回/ 推移转发

如何安装 @harperfast/extended-iterable?

在项目目录运行 npm install @harperfast/extended-iterable,或使用 pnpm add / yarn add / bun add。

@harperfast/extended-iterable 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@harperfast/extended-iterable 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@harperfast/extended-iterable 可以商用吗?

@harperfast/extended-iterable 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@harperfast/extended-iterable 的下载量有多少?

根据 npm 官方下载统计,@harperfast/extended-iterable 在 2026/10/18 – 2026/11/16 这 30 天内被下载 17,582,750 次,日均约 586,092 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@harperfast/extended-iterable 还在维护吗?

最新版本 1.0.5 发布于 2026/10/21(27 天前);至今共发布 5 个版本,其中过去 12 个月发布了 5 个;首次发布于 2025/12/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。