@gmod/range-cache-filehandle

中文文档
2.0.0发布于 2026/10/18MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2.5万

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

中文使用文档
文档目录9 节
  1. 使用量
  2. 行为
  3. 调试
  4. 从1.x升级
  5. 文档
  6. 参考资料
  7. 上面的一层
  8. 证明
  9. 许可证

@ gmod/ range- cache- filehandel

NPM version Build Status

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

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

npm install @gmod/range-cache-filehandle

使用量

滴入为 RemoteFile 从 通用文件手册2数字 :

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 换句话说 其第二个论点 键 此文件的字节位于共享缓存中, 因此它必须识别下面 字节 :

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
  • 每个文件存储其获取的字节范围,只获取 间隙一念叶.
  • 计划每个读数 在同一微任务发布一起。 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 一个人读过所有的.

调试

MIN_REQUEST, (中文(简体) ), PIECE_SIZE, (中文(简体) ), CACHE_LIMIT, (中文(简体) ), CACHE_IDLE_TIMEOUT_MS, (中文(简体) ), MAX_CONCURRENT 财务报告和审定财务报表 RESPONSE_TIMEOUT_MS 导出为读取, 不 设置, 因为缓存是模块- 全球 . 文档/调制版 给出每个后面的测量.

从1.x升级

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

文档

参考资料

上面的一层

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

证明

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

许可证

麻省理工学院

版本与发布记录

@gmod/range-cache-filehandle 共发布 12 个版本,首次发布于 2026/08/16;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.0latest2026/10/1829 天前
1.6.02026/10/1730 天前
1.5.22026/10/151 个月前
1.5.12026/10/121 个月前
1.5.02026/10/011 个月前
1.4.02026/08/242 个月前

关于 @gmod/range-cache-filehandle 的常见问题

@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 和提交记录判断。