前言
在前端开发和快速原型开发中，我们经常需要处理文件和文本数据。处理文件和文本数据的一个常见需求就是对每一行数据进行操作。在 Node.js 中，我们可以使用 fs 模块读取文件内容并对每一行数据进行操作。不过，这种方式需要频繁地使用回调函数和流控制语句，使得代码可能会变得冗长和难以维护。而 for-each-line 就是为了解决这个问题而存在的 npm 包。
for-each-line 是一个高性能、轻量级的 Node.js 模块，帮助我们更轻松地处理文件和文本数据。使用 for-each-line，我们可以非常方便地遍历文件中的每一行，并对每一行数据进行操作，同时也可以自定义分隔符和编码格式进行操作。
安装
安装 for-each-line 可以使用 npm 或者 yarn，安装方法如下：
npm install for-each-line
或者
yarn add for-each-line
使用
for-each-line 的使用非常简单，只需要传入一个文件路径和一个回调函数即可。在回调函数中，我们可以对接下来处理的每一行进行操作。
const forEachLine = require('for-each-line'); forEachLine('./example.txt', (line) => { console.log(line); });
上面的例子中，我们读取了文件 example.txt 中的每一行，并将其打印到控制台中。
API
forEachLine(input, callback[, options])
input<string>文件路径或流对象callback<Function>回调函数，用来处理每一行数据options<Object>可选参数delimiter<string>分隔符，默认为 "\n"encoding<string>编码格式，默认为 "utf8"
回调函数接收一个参数 line，为当前处理的行数据（不包括分隔符）。
返回值
forEachLine 返回一个 Promise 对象，在文件处理结束后调用 Promise.resolve()。
异常处理
如果 input 不是有效的文件路径或流对象，或者回调函数参数不是函数，forEachLine 将抛出一个 TypeError 异常。
示例
以下是一个文件操作的完整示例，首先我们需要创建一个目录和一个文件。
mkdir my-folder cd my-folder echo "hello\nworld" > example.txt
示例代码如下：
-- -------------------- ---- ------- ----- -- - -------------- ----- ----------- - ------------------------- ----- -------- - ---------------- ----------------- ----- ------ -- - -- ----- - ------------------- - ---- -- ---------------- - --------------------- ------ -- - ------------------ ---------- -- - -------------------- --- - ---- - --------------------- -- -- --- - ------ ---------- - ---展开代码
在控制台中运行上述代码，将会输出：
hello world Done
注意事项
for-each-line逐行读取文件内容时使用了流操作，因此对于大文件的处理，需要控制内存消耗。建议使用encoding参数控制编码格式。例如对于 GBK 编码格式的文件，使用如下代码：
forEachLine('./example.txt', (line) => { console.log(line); }, { encoding: 'gbk' });
for-each-line在处理完文件后，会自动调用close方法关闭底层的Readable流。因此，当我们使用 Promise 版本方式时，可以省略finally释放文件句柄等操作。
// 使用 Promise 版本 const promise = forEachLine(filePath, (line) => { console.log(line); }); promise.catch((err) => { console.error(err); }); // 不需要显示释放文件句柄等操作
结语
本文介绍了 for-each-line 的使用方法和 API，通过对其封装，减少了 file, line, callback 的传参，同时也提高了代码的可读性、可维护性和可扩展性。for-each-line 是一个实用的 npm 包，建议在开发中多加使用，减少重复的代码编写。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005604981e8991b448de73d
