# @harperfast/extended-iterable 中文文档

规范地址：https://npmcn.com/package/%40harperfast/extended-iterable/

版本：1\.0\.5
npm 元数据更新时间：2026-10-20T16:04:48.486Z
中文译文更新时间：2026-11-17T10:20:21.241Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40harperfast/extended-iterable
原文对照：https://npmcn.com/package/%40harperfast/extended-iterable/?lang=original
项目主页：https://github.com/harperdb/extended-iterable#readme
源码仓库：https://github.com/harperdb/extended-iterable

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：67.9 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-12-18T14:37:26.425Z
- 最新版本发布：2026-10-20T16:04:48.226Z
- 近 30 天下载量：17582750（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @harperfast/extended-iterable
```

也可以使用：`pnpm add @harperfast/extended-iterable`、`yarn add @harperfast/extended-iterable`、`bun add @harperfast/extended-iterable`

## README

[![license](https://img.shields.io/badge/license-MIT-brightgreen)](https://npmcn.com/package/%40harperfast/extended-iterable/LICENSE) [![npm version](https://img.shields.io/npm/v/extended-iterable.svg?style=flat-square)](https://www.npmjs.org/package/extended-iterable) [![npm downloads](https://img.shields.io/npm/dw/extended-iterable)](https://www.npmjs.org/package/extended-iterable)

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

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

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

```javascript
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` 完全可执行 :

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

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

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

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

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

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

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

### 重排中抓取错误

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

```js
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 是什么？

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

### 如何安装 @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 和提交记录判断。

