简介
stream-to-it 是一个 npm 包，它提供了一些方法，用于将一个可读流转换为迭代器或生成器，以方便 JavaScript 中的异步处理。
本文将以此为主题，介绍 stream-to-it 的使用及其运作原理。
安装
在终端输入以下命令即可安装 stream-to-it。
npm install stream-to-it
使用方法
下面我们用一个简单的例子来演示 stream-to-it 的使用。
-- -------------------- ---- -------
----- -- - --------------
----- ---------- - ------------------------
----- -------- ------ -
----- ------ - ------------------------------- - --------- ------ ---
--- ----- ------ ----- -- -------------------------- -
-------------------
-
-
-------这里的代码使用了 Node.js 的 fs 模块创建了一个可读流，并使用了 toIterable 方法将其转换为了一个迭代器。
迭代器使得我们能够轻松地使用 for await...of 语句来访问流中的数据，而无需担心数据如何传输或如何缓冲等问题。
另外，我们还可以使用 stream-to-it 提供的一些其他方法，例如：
toReadable(iterator, [options])：将一个迭代器转换为一个可读流。toArray(stream)：将一个可读流转换为一个数组。
原理详解
stream-to-it 是如何实现上面的方法的呢？答案就是后面你将要看到的代码。
-- -------------------- ---- -------
-------------- - ----- --------- ---------------- - ------- - ---- - - --- -
--- -
--- ----- ------ ----- -- --------- -
----- ------
-
- ------- -
-- -------- -- ------ ---------------- --- ----------- -
-------------------
-
-
--
------------------ - ----- -------- -------------------- ------- - --- -
----- -------- - --- ----------------
----- ---------------- -
--- -
----- - ------ ---- - - ----- ----------------
-- ------ -
-------------------
-------
-
--------------------------
- ----- ----- -
----------------------
-
--
-------------- -
-- ----------------- -
------------------------
-
--
---
----- ------ - ---------------------
------ -
------------------------ -
------ -----
--
----- ------ -
--- -
----- - ------ ---- - - ----- --------------
------ - ------ ---- --
- ----- ----- -
------ - ------ ---------- ----- ---- --
-
--
----- ------------- -
----- ---------------------
------ - ----- ----- ----- --
--
----- ---------- -
----- -------------------
------ --------------------
--
--
--
--------------- - ----- -------- ----------------- -
----- ------ - ---
--- ----- ------ ----- -- ------------------------- -
-------------------
-
------ -------
--看到这么长的代码你可能有些担心，不用担心，下面我将一步步来讲解。
stream-to-it 的主要概念是将可读流转换为迭代器（即 source 方法），以及将一个迭代器转换为一个可读流（即 toReadable 方法）。
在 source 方法中，我们使用了 JavaScript 中的异步迭代的语法 for await...of 来异步迭代给定的可读流，并在每次迭代时 yield 数据。
在 toReadable 方法中，我们使用了全新的可读流 API（ReadableStream），它是 ECMAScript 中的流，因此不需要任何其他库就能使用。
toReadable 方法中，我们创建了一个 ReadableStream，并使用其 pull() 方法和 iterator.next() 方法进行迭代。
最后，在 toArray 方法中，我们使用了 source 方法来迭代一个给定的可读流，并将每个数据块收集到一个数组中。
这就是 stream-to-it 的实现原理。
总结
stream-to-it 是一个很好的工具，它能大大简化 JavaScript 中的异步操作，而不需要关心数据如何传输或缓冲等问题。在本文中，我们讨论了 stream-to-it 的使用方法和实现原理，希望能对大家有所帮助。
代码示例：
（放个文件输出就行了）
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedb4eeb5cbfe1ea06113a1