在 Node.js 应用程序中，我们常常需要处理来自网络或文件系统的二进制数据。buffer-peek-stream 是一个 npm 包，提供了一种方便的方式来读取和解析二进制数据。
安装
使用 npm 安装 buffer-peek-stream：
--- ------- ------------------
基本用法
下面是一个简单的例子，演示如何使用 buffer-peek-stream 来读取并解析一个包含三个字节的缓冲区：
----- ---------- - ------------------------------ ----- ------ - ------------------ ----- ------- ----- ------ - --- ------------------- ----------------- ------ -- - --------------------- ----- -------------------------- --- ---------------
输出：
-------- ----- ----
在这个例子中，我们创建了一个新的 PeekStream 对象，并将一个包含三个字节的缓冲区传递给它。然后，我们在数据事件回调函数中打印接收到的数据。
最后，我们调用 stream.read(2)，告诉 PeekStream 我们要读取两个字节。由于 PeekStream 会缓存未处理的数据，因此这个调用只会从缓冲区中读取前两个字节。
高级用法
除了基本用法之外，buffer-peek-stream 还提供了一些高级功能，可以帮助我们更方便、更高效地处理二进制数据。
读取固定长度的字节数组
如果我们要读取一个固定长度的字节数组，可以使用 stream.readBuffer(length) 方法。例如：
----- ---------- - ------------------------------ ----- ------ - ------------------ ----- ------- ----- ------ - --- ------------------- --------------------- ------- ------------------------------------------
输出：
-------- ------- ----
查看下一个字节而不消耗它
有时候我们需要查看缓冲区中下一个字节的值，但并不想从缓冲区中消耗这个字节。PeekStream 提供了一个 stream.peek() 方法，可以帮助我们实现这个需求。例如：
----- ---------- - ------------------------------ ----- ------ - ------------------ ----- ------- ----- ------ - --- ------------------- ----------------- ----- ----------------------------------- --------------- ----------------- ---- ----- ----- -----------------------------------
输出：
---- ----- -- ---- ---- ----- ----- --
在这个例子中，我们首先调用了 stream.peek() 方法，获取了缓冲区中下一个字节的值。然后，我们调用 stream.read(1) 从缓冲区中读取了一个字节。最后，我们再次调用 stream.peek() 方法，验证下一个字节的值确实发生了变化。
查找特定字节序列
有时候我们需要查找缓冲区中是否包含特定的字节序列，并在发现该序列时执行特定的逻辑。PeekStream 提供了一个 stream.peekMatch(buffer, offset) 方法，可以帮助我们实现这个需求。例如：
----- ---------- - ------------------------------ ----- ------ - ------------------ ----- ----- ------- ----- ------ - --- ------------------- ----- ----------- - ----------------------------------- ------- --- -- ------------ --- --- - ------------------ ----- -- ------ ----------------- - ---- - ----------- ----------------------------------------------------------- ---------- ---------------------------------------------------------------------------------------