ReadableStreamDefaultReader: releaseLock() 方法

注意:此功能在Web Workers中可用。

releaseLock() 方法是 ReadableStreamDefaultReader 接口的方法,用于释放读取器对流的锁定。

如果在释放锁定时关联的流出现错误,则读取器随后将以相同的方式显示为错误;否则,读取器将显示为已关闭。

如果在读取器仍有挂起的读取请求时释放读取器的锁定,则读取器的 ReadableStreamDefaultReader.read() 方法返回的 Promise 将立即被 TypeError 拒绝。未读取的块保留在流的内部队列中,并且可以通过获取新的读取器稍后读取。

语法

js
releaseLock()

参数

无。

返回值

无 (undefined)。

异常

TypeError

如果源对象不是 ReadableStreamDefaultReader,则抛出。

示例

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

  // ...

  reader.releaseLock();

  // ...
}

规范

规范
流标准
# ref-for-default-reader-release-lock②

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅