此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

ReadableStreamDefaultReader.releaseLock()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.

ReadableStreamDefaultReader 接口的 releaseLock() 方法用于释放 reader 对流的锁定。

如果释放锁时关联流出错,reader 随后会以同样的方式发生错误;此外,reader 将关闭。

如果在 reader 仍有待处理的读取请求时释放了锁,那么 reader 的 ReadableStreamDefaultReader.read() 方法返回的 promise 将立刻使用 TypeError 拒绝。未读的分块将会保留在内部队列中,并且稍后可以通过获取一个新的 reader 读取。

语法

js
releaseLock()

参数

无。

返回值

无 (undefined)。

异常

TypeError

如果源对象不是 ReadableStreamDefaultReader 则抛出该异常。

示例

js
function fetchStream() {
  const reader = stream.getReader();

  // ...

  reader.releaseLock();

  // ...
}

规范

Specification
Streams
# ref-for-default-reader-release-lock②

浏览器兼容性

参见