Nodejs v14.3.0 发布支持顶级 Await 和 REPL 增强功能 - 图1
本周，Nodejs v14.3.0 发布。这个版本包括添加顶级 Await、REPL 增强等功能。

REPL 增强

通过自动补全改进对 REPL 的预览支持，例如，下图中当输入 process.ver 之后，不需要输入剩下的实际内容，它帮我们生成了自动补全的输入预览。

image.png

顶级 Await 支持

不再需要更多的 “async await, async await…” 支持在异步函数之外使用 await 关键字。

REPL 环境下应用

在 REPL 环境下做了一个测试，似乎并没有正常工作，得到了一些错误，这是为什么呢？

image.png

根据规范，仅支持在 ES Modules 模块中可用，参考 tc39/proposal-top-level-awai

我们不能提供 “—input-type=module” 这样的标志到 REPL 环境， 这一次在 node 后加上标志 —experimental-repl-await 看以下示例，现在它可以正常工作了。

image.png

ES Modules 下应用

Nodejs 在版本 v13.2.0 取消了标记 —experimental-module 可以直接使用 ES Modules。

一种使用方式是文件后缀名使用 .mjs，另一种使用方式是还使用原来的 .js 文件，但是要设置 package.json 的 type=module，详情可以去官网查看 nodejs.org/api/esm.html

1. 创建 index.mjs

以下示例中我们使用 setTimeout 模拟了一个 sleep 函数，在指定的延迟时间下打印输出。

  1. const sleep = (millisecond, value) => {
  2.   return new Promise(resolve => setTimeout(() => resolve(value), millisecond));
  3. };
  5. const val1 = await sleep(1000, 'Output hello after 1 second.');
  6. console.log(val1);
  7. const val2 = await sleep(2000, 'Output Nodejs after 1 second.');
  8. console.log(val2);

2. 运行 index.mjs

直接这样执行，仍然会得到一个错误，但是看最新发布的 v14.3.0 说明，也没有说明要提供什么标志，这一点产生了困惑。

Support for Top-Level Await

It’s now possible to use the await keyword outside of async functions.

  1. $ node index.mjs   
  2. file:///index.mjs:5
  3. const val1 = await sleep(1000, 'Output hello after 1 second.');
  4.              ^^^^^
  5. SyntaxError: Unexpected reserved word

在 Github issues Top-level await throws SyntaxError 上发现了一个同样的问题，解释了这个原因，在当前版本 v14.3.0 中运行时我们仍需要加上如下两个标志:

  1. --experimental_top_level_await or --harmony_top_level_await

3. 再次运行 index.mjs

这一次运行结果是我们的期望值。

  1. $ node --experimental_top_level_await index.mjs
  2. Output hello after 1 second.
  3. Output Nodejs after 1 second.

Top-level await 的用途

上面介绍了 Top-level await 该如何使用，这里说下它的用途，个人认为一个比较有用的是我们可以在文件的头部做一些资源的初始化。

创建 initialize-mongo-instance.mjs

下面定义了一个初始化 MongoDB 实例的方法 initializeMongoInstance()

  1. // initialize-mongo-instance.mjs
  2. import mongodb from 'mongodb';
  4. const dbConnectionUrl = 'mongodb+srv://<user>:<password>@cluster0-on1ek.mongodb.net/test?retryWrites=true&w=majority';
  5. const { MongoClient } = mongodb;
  7. export default function initializeMongoInstance (dbName, dbCollectionName) {
  8.   return MongoClient.connect(dbConnectionUrl, { useUnifiedTopology: true })
  9.     .then(dbInstance => {
  10.       const dbObject = dbInstance.db(dbName);
  11.       const dbCollection = dbObject.collection(dbCollectionName);
  13.       console.log("[MongoDB connection] SUCCESS");
  14.       return dbCollection;
  15.     }).catch(err => {
  16.       console.log(`[MongoDB connection] ERROR: ${err}`);
  18.       throw err;
  19.     });
  20. }

index.mjs

例如，index.mjs 为我的启动文件，在启动时需要初始化上面定义的 initializeMongoInstance 方法，如果是之前只能写在一个 async 声明的异步函数中，现在有了 Top-level await 支持，可以直接像如下方式来写：

  1. import initializeMongoInstance from './initialize-mongo-instance.mjs';
  2. const testCollection = await initializeMongoInstance('dbName', 'test');

Reference

作者简介：五月君，Nodejs Developer，慕课网认证作者，热爱技术、喜欢分享的 90 后青年，欢迎关注 Github 开源项目 https://www.nodejs.red