# @browsery/stream 中文文档 规范地址：https://npmcn.com/package/%40browsery/stream/ 版本：4\.7\.0-rev\.1 npm 元数据更新时间：2026-10-07T15:33:23.252Z 中文译文更新时间：2026-11-08T16:34:58.773Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40browsery/stream 原文对照：https://npmcn.com/package/%40browsery/stream/?lang=original 项目主页：https://github.com/panates/browsery#readme 源码仓库：https://github.com/panates/browsery ## 关键信息（来自 npm 元数据） - 包体积（解压后）：253 kB，5 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：6 个 - 首次发布：2023-01-09T17:09:56.261Z - 最新版本发布：2026-10-07T15:33:22.893Z - 近 30 天下载量：3642（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：17（近 12 个月 3 个） ## 中文简介 兼容节点JS流模块 ## 安装 ```sh npm install @browsery/stream ``` 也可以使用：`pnpm add @browsery/stream`、`yarn add @browsery/stream`、`bun add @browsery/stream` ## README # @ 浏览/ 流 浏览器兼容节点JS流 API! 此模块捆绑 [可读流](https://www.npmjs.com/package/readable-stream) 浏览器模块 ! # 可读流 **_用于使用地的节点.js核心流_** [![npm status](https://img.shields.io/npm/v/readable-stream.svg)](https://npm.im/readable-stream) [![node](https://img.shields.io/node/v/readable-stream.svg)](https://www.npmjs.org/package/readable-stream) [![Node.js Build](https://github.com/nodejs/readable-stream/workflows/Node.js/badge.svg)](https://github.com/nodejs/readable-stream/actions?query=workflow%3ANode.js) [![Browsers Build](https://github.com/nodejs/readable-stream/workflows/Browsers/badge.svg)](https://github.com/nodejs/readable-stream/actions?query=workflow%3ABrowsers) ```bash npm install readable-stream ``` 这个套件是Node.js 18.19.0中流执行的镜像. 详细文件可在 [节点.js网站](https://nodejs.org/dist/v18.19.0/docs/api/stream.html)。 。 。 . 如果你想保证一个稳定的溪流基础,无论哪个版本 节点,或您的库的用户正在使用,使用 **可读流** _仅限_ 并避开 _"流" ("流")_ 模块,背景参见 [这个博客帖](http://r.va.gg/2014/06/why-i-dont-use-nodes-core-stream-module.html)。 。 。 . 至2.0版为止 **可读流** 使用语义版本. ## 版本4.x.x v4.x.x 时速 `readable-stream` 是18号节点的切口 这个版本支持节点12,14,16和18,以及常绿浏览器. V4引入的分解变化由以下分解的分解变化组成: - [节点 v12](https://nodejs.org/en/blog/release/v12.0.0/) - [节点 v13](https://nodejs.org/en/blog/release/v13.0.0/) - [节点 v14](https://nodejs.org/en/blog/release/v14.0.0/) - [节点 v15](https://nodejs.org/en/blog/release/v15.0.0/) - [节点 v16](https://nodejs.org/en/blog/release/v16.0.0/) - [节点 v17](https://nodejs.org/en/blog/release/v17.0.0/) - [节点 v18](https://nodejs.org/en/blog/release/v18.0.0/) 这还包括: _数量_ 新的特性. ## 3.x.x版本 维基百科中的相关条目: 维基百科 v3.x.x 处 `readable-stream` 是从10号节点切出 这个版本支持Node 6,8和10,以及常绿浏览器,IE 11和最新的Safari. v3引入的分解变化由合并分解变化组成 : [节点 v9](https://nodejs.org/en/blog/release/v9.0.0/) 财务报告和审定财务报表 [节点 v10](https://nodejs.org/en/blog/release/v10.0.0/),内容如下: 1. 错误代码 : [https://github.com/nodejs/node/pull/13310 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/13310), (中文(简体) ), [https://github.com/nodejs/node/pull/13291 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/13291), (中文(简体) ), [https://github.com/nodejs/node/pull/16589 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/16589), (中文(简体) ), [https://github.com/nodejs/node/pull/15042 (英语)](https://github.com/nodejs/node/pull/15042), (中文(简体) ), [https://github.com/nodejs/node/pull/15665 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/15665), (中文(简体) ), [https://github.com/nodejs/可读-流/pull/344 (中文(简体) )](https://github.com/nodejs/readable-stream/pull/344) 2. "可读"优先于流动 [https://github.com/nodejs/node/pull/18994 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/18994) 3. 使虚拟方法错误一致 [https://github.com/nodejs/node/pull/18813 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/18813) 4. 更新流错误处理 [https://github.com/nodejs/node/pull/18438 (英语)](https://github.com/nodejs/node/pull/18438) 5. 可写. end should return this. 最终应该归还它. [https://github.com/nodejs/node/pull/18780 (英语)](https://github.com/nodejs/node/pull/18780) 6. 可读性在按下(')时继续读取 [https://github.com/nodejs/node/pull/18211 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/18211) 7. 添加自定义检查到缓冲列表 [https://github.com/nodejs/node/pull/17907 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/17907) 8. 总是将“ 可读” 推迟到下一个 Tick [https://github.com/nodejs/node/pull/17979 页面存档备份,存于互联网档案馆](https://github.com/nodejs/node/pull/17979) ## 版本 2.x.x v2.x.x 时速 `readable-stream` 是一个从节点8切入流模块(从节点4到8没有Semver-major变化)。 这个版本支持从0.8的所有Node.js版本,以及常绿浏览器和IE 10 & 11. # 使用量 你可以交换你的 `require('stream')` 与 `require('readable-stream')` 如果你只是用主课之一 函数. ```js const { Readable, Writable, Transform, Duplex, pipeline, finished } = require('readable-stream') ``` 请注意: `require('stream')` 将返回 `Stream`时 `require('readable-stream')` 将返回 `Readable`我们劝阻使用 直接导出的东西,但使用其中一个属性作为 以上例子所示. ## 在浏览器中使用 你需要一个像 [`browserify`](https://github.com/browserify/browserify#readme), (中文(简体) ), [`webpack`](https://webpack.js.org/), (中文(简体) ), [`parcel`](https://github.com/parcel-bundler/parcel#readme) 或类似。 自4.2.0版本起不再需要多填充. # 流工作组 `readable-stream` 由流工作组维持,工作组 监督开发和维护 节点.js. 流动工作组的职责包括: - 在Node.js问题跟踪器上处理流出问题. - 在Node.js项目内编写并编辑流文件. - 审查节点.js项目内流子类的变化. - 从Node.js项目到此方向的修改 项目. - 协助在Node.js范围内实施溪流提供者. - 建议文本 `readable-stream` 将列入Node.js. - 关于溪流未来的新闻 给社区进步 更改通知. ## 小组成员 - **马蒂亚斯·布斯** (单位:千美元)[@ mafintosh:我最爱的是](https://github.com/mafintosh)) (中文(简体) ) - **马特奥·科利纳** (单位:千美元)[@mcollina (英语)](https://github.com/mcollina)) (中文(简体) ) - 释放出 GPG 键: 3ABC01543 F22DD2229285 CDD818674489 FBC127E - **罗伯特·纳吉** (单位:千美元)[@ ronag](https://github.com/ronag)) (中文(简体) ) - **文森特·韦弗斯** (单位:千美元)[@vweivers (英语)](https://github.com/vweevers)) (中文(简体) ) ## 常见问题 ### @browsery/stream 是什么？ 兼容节点JS流模块 ### 如何安装 @browsery/stream？ 在项目目录运行 npm install @browsery/stream，或使用 pnpm add / yarn add / bun add。 ### @browsery/stream 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @browsery/stream 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @browsery/stream 可以商用吗？ @browsery/stream 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @browsery/stream 的下载量有多少？ 根据 npm 官方下载统计，@browsery/stream 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,642 次，日均约 121 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @browsery/stream 还在维护吗？ 最新版本 4\.7\.0-rev\.1 发布于 2026/10/07（1 个月前）；至今共发布 17 个版本，其中过去 12 个月发布了 3 个；首次发布于 2023/01/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。