简介
match-stream 是一个可以方便地在 Node.js 流中进行匹配的工具。通过使用 match-stream，你可以轻松地从流中提取想要的数据。
安装
你可以通过 npm 来安装 match-stream：
--- ------- ------------
用法
基本用法
首先，我们需要将 match-stream 引入到我们的项目中：
----- ----------- - ------------------------
然后，我们可以创建一个匹配器，并将其传递给 MatchStream 的构造函数。这个匹配器可以是一个字符串、一个正则表达式，或者一个自定义的函数：
-- ---------- ----- ------- - ------ -- ------------ ----- ------- - ------ -- ------------ ----- ------- - ------- -- ---------------------------------
接下来，我们可以将我们的流传递给 MatchStream 的构造函数，并注册一个回调函数来处理匹配结果：
----- ------ - -- ----- ----- ----------- - --- --------------------- ----------------------- ------- -------- ------ -- - ----------------- ------------- -------- ----- ---
在这里，当我们的流中有数据被匹配到时，就会触发 match 事件，并且回调函数会接收到一个包含匹配结果的对象。这个对象包含了三个属性：
chunk：被匹配到的数据块。matched：匹配到的字符串或正则表达式。count：已经匹配到的次数。
高级用法
除了基本用法之外，match-stream 还有一些高级用法可以帮助我们更好地控制匹配流程。
匹配模式
默认情况下，match-stream 会在流中搜索所有匹配项。但是，在某些情况下，我们可能只想要匹配第一个或最后一个匹配项。为了支持这种场景，match-stream 提供了多种匹配模式：
'first'：只匹配第一个匹配项。'last'：只匹配最后一个匹配项。'all'：匹配所有匹配项（默认）。
----- ----------- - --- -------------------- - ----- ------- ---
缓冲区大小
MatchStream 默认会将所有的数据缓存起来，然后在整个流结束之后进行匹配。但是，在某些情况下，我们可能需要在缓存的数据量达到一定大小之后就开始匹配。为了支持这种场景，match-stream 允许你设置缓冲区的大小：
----- ----------- - --- -------------------- - ----------- ---- ---
在这里，我们将缓冲区大小设置为 1024 字节。当缓存的数据量达到这个值时，就会开始匹配。
匹配数据类型
默认情况下，match-stream 会将流中的数据块视为字符串进行匹配。但是，在某些情况下，我们可能需要将数据块转换为其他类型，例如 JSON、Buffer 等等。为了支持这种场景，match-stream 允许你设置匹配数据类型：
----- ----------- - --- -------------------- - --------- ------ ---
在这里，我们将匹配数据类型设置为 JSON。这意味着，当流中有一个 JSON 对象时，我们可以直接通过属性名来匹配对应的字段。
示例代码
----- -- - -------------- ----- ----------- - ------------------------ -- -------- ----------------------------------------------------------- ---------- ---------------------------------------------------------------------------------------