如何通过迭代器实现对原始二进制 Buffer 数据的按字节流遍历-js教程-PHP中文网

可通过自定义迭代器实现buffer按字节流式访问；buffer本身不支持for...of，需实现[symbol.iterator]()方法返回含next()的迭代器对象，每次返回0–255的字节值及done状态。

如何通过迭代器实现对原始二进制 buffer 数据的按字节流遍历

可以通过创建一个自定义迭代器，将 Buffer 按字节逐个暴露为可遍历的数值序列，实现真正的按字节流式访问。

理解 Buffer 与迭代器的关系

Buffer 是 Node.js 中用于处理二进制数据的类数组对象，本身不原生支持 for...of 或展开语法（如 [...buf]），但可通过实现 [Symbol.iterator]() 方法赋予其迭代能力。该方法需返回一个符合迭代器协议的对象（含 next() 方法），每次调用返回下一个字节值（0–255 的整数）及 done 状态。

手写字节级迭代器（兼容所有 Buffer 版本）

以下是一个轻量、无依赖的实现方式：

ColaOS

一款AI工具，主要用于首个有灵魂的智能体操作系统，适合需要提升相关任务效率的用户。

下载

function* bufferBytes(buf) {
  for (let i = 0; i // 使用示例
const buf = Buffer.from([0x48, 0x65, 0x6c, 0x6c, 0x6f]); // "Hello"
for (const byte of bufferBytes(buf)) {
console.log(byte.toString(16)); // 输出: 48 65 6c 6c 6f
}

使用 function* 生成器语法最简洁，自动满足迭代器协议
直接通过索引访问 buf[i]，避免拷贝或切片，内存零开销
适用于任意长度 Buffer，包括超大文件分块读取后的 chunk

扩展：支持反向遍历与范围截取

若需更灵活控制，可封装成可配置的迭代器类：

class BufferByteIterator {
  constructor(buf, { start = 0, end = buf.length, reverse = false } = {}) {
    this.buf = buf;
    this.index = reverse ? buf.length - 1 : start;
    this.end = reverse ? -1 : end;
    this.step = reverse ? -1 : 1;
  }
<p>[Symbol.iterator]() {
return this;
}</p><p>next() {
if (this.index === this.end) {
return { value: undefined, done: true };
}
const value = this.buf[this.index];
this.index += this.step;
return { value, done: false };
}
}</p><p>// 反向遍历最后 3 字节
const tailIter = new BufferByteIterator(buf, { start: buf.length - 3, reverse: true });
for (const b of tailIter) console.log(b); // 108 101 72（对应 l, e, H）
</p>