promise_read

### 关于 `promise_read` 的实现

为了更好地理解如何使用 JavaScript Promises 进行文件读取操作，可以创建一个名为 `promise_read` 的函数来封装这一过程。此函数将利用 Node.js 中的 `fs.promises.readFile` 或者通过 promisify 将传统的回调风格 API 转换成 Promise 风格。

#### 实现方式一：直接使用 `fs.promises`

Node.js 提供了一个内置模块 `fs/promises` 来处理文件系统的异步 I/O 操作并返回 Promise 对象：

const fs = require('fs').promises;

async function promise_read(filePath, encoding) {
    try {
        const data = await fs.readFile(filePath, encoding);
        return data;
    } catch (error) {
        throw new Error(`Failed to read the file ${filePath}: ${error.message}`);
    }
}

这段代码定义了 `promise_read` 函数，它接受两个参数——路径名 (`filePath`) 和编码格式 (`encoding`)。当调用该函数时，它会尝试读取指定位置上的文件，并在成功后返回其内容；如果发生任何异常情况，则抛出带有描述性的错误消息[^1]。

#### 实现方式二：Promisifying 回调版本的 `readFile`

如果不希望依赖较新的 Node 版本提供的原生支持，也可以手动 promisify 旧版 `fs` 模块下的 `readFile` 方法:

const util = require('util');
const fs = require('fs');

// 创建一个新的 readFile 函数，它是原始 fs.readFile 的承诺化版本
const readFilePromise = util.promisify(fs.readFile);

async function promise_read(filePath, encoding) {
    try {
        let content = await readFilePromise(filePath, encoding);
        return content.toString();
    } catch (err) {
        console.error(err);
        throw err; // 把捕获到的错误重新抛出去以便外部处理
    }
}

这里展示了另一种构建 `promise_read` 的途径，即通过对标准库里的同步/回调接口应用 `util.promisify()` 工具函数来进行转换。

---

上述两种方法都可以有效地简化基于回调的传统编程模型向更现代、易于管理的 Promise-based 流程迁移的过程。对于大多数应用场景而言，推荐采用第一种方案因为它更加简洁明了且不需要额外引入工具包。