ByteLengthQueuingStrategy 是 Web Streams API 中按字节长度而非数量限制流队列容量的背压策略，通过 size 方法返回 chunk.byteLength 或 UTF-8 字节数，配合 highWaterMark（单位字节）控制内存水位，适用于大文件上传、长文本解析等需防 OOM 场景。
ByteLengthQueuingStrategy 是 Web Streams API 中用于控制可读流或可写流内部队列容量的策略之一，它按数据块的字节长度而非数量来限制缓冲区大小，特别适合处理体积差异大的流式内容（如视频分片、大 JSON 响应、文件上传等），避免小请求堆积、大响应阻塞的问题。
核心原理：用字节代替“个数”做水位线
默认情况下，流队列使用 CountQueuingStrategy，每块数据计为 1 单位，不管它是 10 字节还是 10 MB。而 ByteLengthQueuingStrategy 把 size 方法定义为返回 chunk.byteLength（对 ArrayBuffer/Uint8Array）或 chunk.length（对字符串），让流引擎能真实感知内存压力。
- 构造时传入
highWaterMark，单位是字节，例如new ByteLengthQueuingStrategy({ highWaterMark: 1_000_000 })表示队列最多缓存 1MB 数据 - 当队列中已缓存字节数 ≥ highWaterMark，流会自动暂停读取（
readableStream.getReader()的read()返回{ done: false, value: undefined }，且readyPromise 暂不 resolve） - 只有消费者调用
reader.read()并处理完数据后，字节数才从队列中扣除，流才可能恢复读取
典型应用场景与写法
适用于需要内存可控、防 OOM、或带宽敏感的双向流场景：
-
接收大文件上传流：服务端用
fetch接收ReadableStream，前端通过ByteLengthQueuingStrategy控制客户端缓冲上限，防止浏览器内存暴涨 -
解析长文本流（如日志、CSV）：按行或按块读取时，若某块超大（如单行含 50MB 日志），
CountQueuingStrategy会误判为“只占 1 个位置”，而ByteLengthQueuingStrategy能立即触发背压 - 构建自定义转换流（TransformStream）：在压缩、加密、分块等中间处理环节，用字节策略确保中间缓冲不过载
示例（读取响应体并限制总缓存为 2MB）：
const response = await fetch('/api/large-data');
const reader = response.body
.pipeThrough(new TextDecoderStream())
.getReader({
strategy: new ByteLengthQueuingStrategy({ highWaterMark: 2_000_000 })
});
while (true) {
const { done, value } = await reader.read();
if (done) break;
processChunk(value); // 如解析 JSON、写入 IndexedDB
}
注意事项与常见陷阱
该策略依赖你准确提供每个 chunk 的字节长度，否则背压失效：
- 对
Uint8Array、ArrayBuffer、Blob等二进制类型，size方法必须返回chunk.byteLength - 对字符串，需注意编码：UTF-8 下中文字符占 3 字节，直接用
str.length会严重低估；建议转为Uint8Array后计算，或使用new TextEncoder().encode(str).length - 不能混用不同 size 计算逻辑：比如一部分 chunk 按 UTF-16 length 算，另一部分按 UTF-8 byteLength 算，会导致 highWaterMark 失效
- 它不替代网络层限速，也不影响 TCP 窗口或服务器发送节奏，仅作用于 JS 层流队列的内存水位控制
配合流式响应提升体验
搭配服务端流式输出（如 Node.js 的 res.write() 或 Cloudflare Workers 的 stream.pipeTo()），ByteLengthQueuingStrategy 可实现“边收边处理”，避免等待整个响应完成：
- 用户上传大文件时，前端可实时显示已接收字节数，并在达到 highWaterMark 时提示“处理中，请稍候”，而不是卡死
- 视频播放器加载分片时，用该策略控制解码前缓冲量，防止低端设备内存溢出
- AI 流式响应（SSE 或 text/event-stream）中，按 token 字节数控制 UI 渲染节奏，避免 DOM 过度重排
