# @gmod/range-cache-filehandle 中文文档

规范地址：https://npmcn.com/package/%40gmod/range-cache-filehandle/

版本：2\.0\.0
npm 元数据更新时间：2026-10-18T13:53:36.507Z
中文译文更新时间：2026-11-16T17:10:30.586Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gmod/range-cache-filehandle
原文对照：https://npmcn.com/package/%40gmod/range-cache-filehandle/?lang=original
项目主页：https://github.com/GMOD/range-cache-filehandle#readme
源码仓库：https://github.com/GMOD/range-cache-filehandle

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

- 包体积（解压后）：402 kB，53 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-08-16T03:20:57.203Z
- 最新版本发布：2026-10-18T13:53:36.019Z
- 近 30 天下载量：25172（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

缓存字节区域在块和相邻的集合中的文件处理器读取到一个请求

## 安装

```sh
npm install @gmod/range-cache-filehandle
```

也可以使用：`pnpm add @gmod/range-cache-filehandle`、`yarn add @gmod/range-cache-filehandle`、`bun add @gmod/range-cache-filehandle`

## README

# @ gmod/ range- cache- filehandel

[![NPM version](https://img.shields.io/npm/v/@gmod/range-cache-filehandle.svg?style=flat-square)](https://npmjs.org/package/@gmod/range-cache-filehandle) ![Build Status](https://img.shields.io/github/actions/workflow/status/GMOD/range-cache-filehandle/publish.yml?branch=main)

A 类 `GenericFilehandle` 缓存它所获取的字节区域并连接在一起 附近读到一个请求.

指数化的基因组分析器使许多小的,相邻的,半随机读取,大多数 接近它刚刚做的。 这层坐落在解析器下, 将那些读作 并服务下一个查询的重叠读取内存.

```sh
npm install @gmod/range-cache-filehandle
```

## 使用量

滴入为 `RemoteFile` 从 [通用文件手册2](https://github.com/GMOD/generic-filehandle2)数字 :

```js
import { RemoteFileWithRangeCache } from '@gmod/range-cache-filehandle'
import { CramFile } from '@gmod/cram'

const cram = new CramFile({
  filehandle: new RemoteFileWithRangeCache('https://example.com/file.cram'),
})
```

`CachedFilehandle` 覆盖本地文件或 `Blob` 换句话说 其第二个论点 键 此文件的字节位于共享缓存中, 因此它必须识别下面 字节 :

```js
import { CachedFilehandle } from '@gmod/range-cache-filehandle'
import { LocalFile } from 'generic-filehandle2'

const file = new CachedFilehandle(new LocalFile(path), `file://${path}`)
```

## 行为

![Two reads issued in one turn: one is partly cached and partly in flight, and their four gaps become three range requests](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/img/extents.svg)

-   每个文件存储其获取的字节范围,只获取 间隙一念叶.
-   计划每个读数 在同一微任务发布一起。 64岁以下差距 KiB增长到64个KiB,64个KiB内部的缺口相互共享一个请求.
-   加入另一个读数正在飞行的请求,而不是再次询问.
-   引用对每个请求的阅读器进行计数, 因此共享请求仅被取消 一旦他们全部流产。 一个读取者通过没有信号 把它钉在每个人.
-   每名工人持有256个米B,驱逐最近使用最少的一块米B 搜索字节闲置15分钟. `clearCache()` 放弃一切, `clearCacheFor(key)` 丢弃一个文件, `sweepIdleCache()` 早熟的, `setCacheLimit(bytes)` 更改上限和 `cachedBytes()` 报告什么 缓存持有.
-   一次运行20个请求 **来源**。 。 。 .
-   学习文件大小 `Content-Range`,416,一个比它短的体型 请求,或 `stat()`夹子读取它.
-   需要一个支持范围请求的服务器 。 A 类 `200` 到范围请求是 错误和 a `206` 谁 `Content-Range` 不是要丢的幅度 而不是被缓存.
-   列出失败的原因: CORS, 混合内容, 服务器忽略范围 标题,一个连接 30多,没有回答.

缓存从不重复请求, 也没有对传输设定时限, 只在 等待回复开始。 为了停止阅读,中止 `AbortSignal` 你们 通过;缓存将信号传递到插座.

[文件/数据流.md](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/dataflow.md) 一个人读过所有的.

## 调试

`MIN_REQUEST`, (中文(简体) ), `PIECE_SIZE`, (中文(简体) ), `CACHE_LIMIT`, (中文(简体) ), `CACHE_IDLE_TIMEOUT_MS`, (中文(简体) ), `MAX_CONCURRENT` 财务报告和审定财务报表 `RESPONSE_TIMEOUT_MS` 导出为读取, 不 设置, 因为缓存是模块- 全球 . [文档/调制版](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/tuning.md) 给出每个后面的测量.

## 从1.x升级

-   `setChunkCacheLimit(bytes)` 实值 `setCacheLimit(bytes)`,限制是准确的 字节而不是整个256个基B块.
-   `CHUNK_SIZE` 财务报告和审定财务报表 `MAX_CACHE_ENTRIES` 已经走了; `MIN_REQUEST`, (中文(简体) ), `PIECE_SIZE` 财务报告和审定财务报表 `CACHE_LIMIT` 替换它们.
-   A 类 `200` 至范围请求即使请求开始于字节,也是错误 0,且一个没有可读长度的416在文件开始时绑定它 范围。 两者都假设一个支持范围的服务器.
-   `CachedFilehandle` 拒绝在同一密钥下缓存的内控.
-   一个请求在读完需要的微任务后,会发出一个微任务.

## 文档

-   [文件/附录](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/api.md) - 每一份出口
-   [文件/优化](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/optimizations.md) - 切除请求数的是什么
-   [文件/数据流.md](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/dataflow.md) ——读取流程如何
-   [文件/共享.md](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/sharing.md) 共享请求和中止
-   [文档/调制版](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/tuning.md) ——常数及其测量
-   [文件/误差](https://npmcn.com/package/%40gmod/range-cache-filehandle/docs/errors.md) ——每个故障报告的内容

## 参考资料

-   [RFC 9110 (法语)](https://www.rfc-editor.org/rfc/rfc9110.html) HTTP语义: [范围](https://www.rfc-editor.org/rfc/rfc9110.html#section-14.2) 第14.2节, [内容范围](https://www.rfc-editor.org/rfc/rfc9110.html#section-14.4) 第14.4节, [206 (韩语)](https://www.rfc-editor.org/rfc/rfc9110.html#section-15.3.7) 第15.3.7节, [第416次会议](https://www.rfc-editor.org/rfc/rfc9110.html#section-15.5.17) 第15.5.17节
-   [什么WG DOM: 依赖信号](https://dom.spec.whatwg.org/#abortsignal-dependent-signals) 为什么 `AbortSignal.any` 长生不老的呼叫器信号不泄露
-   [何为wg/tick#951](https://github.com/whatwg/fetch/issues/951) 为什么 `fetch` 没有超时
-   [每端比率限制](https://copdips.com/2023/01/python-aiohttp-rate-limit.html) - 模式 `MAX_CONCURRENT` 用途

## 上面的一层

范围- cache- filehandle 缓存字节。 每个通过它读取的解析器 缓存它分析的东西, 单独的预算和闲置的超时 缓存表示读数从未到达此层 :

-   [翻译:](https://github.com/GMOD/bam-js) —— 说 [缩写( m)](https://github.com/GMOD/bam-js/blob/main/docs/caching.md)
-   [@ gmod/ cram (英语)](https://github.com/GMOD/cram-js) —— 说 [记忆](https://github.com/GMOD/cram-js/blob/main/docs/memory.md)
-   [@gmod/tabix (英语)](https://github.com/GMOD/tabix-js) —— 说 [缩写( m)](https://github.com/GMOD/tabix-js/blob/main/docs/caching.md)
-   [@gmod/bbi (英语)](https://github.com/GMOD/bbi-js) —— 说 [货币](https://github.com/GMOD/bbi-js/blob/main/docs/concurrency.md)

## 证明

-   从JBrowse 2中取出,原地取出 `@jbrowse/core/util/io/RemoteFileWithRangeCache`,所以解析器可以使用它 不取决于 `@jbrowse/core`。 。 。 .
-   替换 [http-range-fetcher (英语)](https://github.com/rbuels/http-range-fetcher), (中文(简体) ), 将最后100ms中的请求合并。 此软件包合并 读取的空白在一个微任务转弯中发布, 所以它等待不计时器, 它 通过一个 `AbortSignal` 穿过插座.

## 许可证

麻省理工学院

## 常见问题

### @gmod/range-cache-filehandle 是什么？

缓存字节区域在块和相邻的集合中的文件处理器读取到一个请求

### 如何安装 @gmod/range-cache-filehandle？

在项目目录运行 npm install @gmod/range-cache-filehandle，或使用 pnpm add / yarn add / bun add。

### @gmod/range-cache-filehandle 支持 TypeScript 吗？

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

### @gmod/range-cache-filehandle 支持 ESM 还是 CommonJS？

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

### @gmod/range-cache-filehandle 可以商用吗？

@gmod/range-cache-filehandle 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gmod/range-cache-filehandle 的下载量有多少？

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

### @gmod/range-cache-filehandle 还在维护吗？

最新版本 2\.0\.0 发布于 2026/10/18（29 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/08/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

