如何利用 ReadableStream.getReader() 锁住可读流并开启底层读取器

夏敏同学_7720

夏敏同学_7720

2026-06-01

321人浏览

原创

调用 readablestream.getreader() 会独占锁住流,同一时间仅允许一个活跃 reader,重复调用抛出 typeerror;锁通过 [[locked]] 内部槽控制,禁止再次 getreader()、pipeto()、pipethrough() 及 byob 模式读取;锁确保读取顺序性,不阻塞数据流入;开启底层读取需调用 reader.read(),返回 promise 并触发 pull() 或返回缓存 chunk;锁需显式释放:读完自动解锁、cancel() 主动终止或 finally 中调用 cancel()/releaselock();未读未取消将导致流永久锁定。

如何利用 readablestream.getreader() 锁住可读流并开启底层读取器

调用 ReadableStream.getReader() 会立即获取一个 ReadableStreamDefaultReader 实例,并**独占性地锁住该流**——这意味着同一时间只能有一个活跃的 reader,后续再调用 getReader() 会直接抛出 TypeError(提示“stream is locked”)。

锁住流的本质与影响

锁是流对象内部的一个状态标记([[locked]] 内部槽),一旦设为 true,以下操作将被禁止:

  • 再次调用 getReader()
  • 调用 pipeTo()、pipeThrough()
  • 调用 getReader({ mode: 'byob' })(即使模式不同也不行)

锁的存在是为了避免多个消费者竞争读取,保证数据消费的确定性和顺序性。它不阻塞底层源(如 fetch() 响应体),数据仍会持续流入队列,只是读取控制权交给了当前 reader。

开启底层读取器的实际步骤

所谓“开启底层读取器”,本质是通过 reader 的 read() 方法触发流的内部读取机制。每次调用 read() 会:

  • 若内部队列有数据,立即返回已缓存的 chunk({ value, done: false })
  • 若队列为空且流未关闭/取消,向底层源请求新数据(例如触发 pull() 回调)
  • 若流已关闭,返回 { value: undefined, done: true }

注意:read() 返回的是 Promise,需用 await 或 .then() 处理;不主动调用 read(),reader 虽存在但底层不会启动拉取逻辑。

MedPeer天生会写
MedPeer天生会写

一款AI论文写作工具,主要用于全流程智能科研文稿生成平台,基于真实文献,一键生成优质全文,全学科适用,适合需要提升相关任务效率的用户。

下载

释放锁与正确清理

锁不会自动释放,必须显式终止 reader:

  • 读完并关闭:持续 read() 直到 done: true,然后 reader 自动解锁
  • 主动取消:调用 reader.cancel(reason),流进入 closed 状态并解锁
  • 异常中断:reader 被垃圾回收前未完成或取消,流可能卡在 readable 状态,但锁仍存在——此时应确保 finally 中调用 cancel() 或 releaseLock()(仅限已读完)

⚠️ 错误做法:创建 reader 后不读也不 cancel,会导致流永久锁定,后续任何消费方式都失效。

常见场景示例

比如处理 fetch 响应流:

const response = await fetch('/data');
const reader = response.body.getReader(); // 此刻流已被锁
let result = new Uint8Array(0);

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  // 拼接 chunk
  const newResult = new Uint8Array(result.length + value.length);
  newResult.set(result);
  newResult.set(value, result.length);
  result = newResult;
}
// reader 自动解锁,result 即完整响应体

如果中途想中止,改用 reader.cancel('abort') 即可提前解锁并终止底层传输。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4806

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1189

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4724

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

940

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1856

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3405

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4433

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2900

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

928

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习