image.png
Node.js v17.5.0 版本于本周四(2022-02-10)发布,其显著变化为:

  • 试验性支持 fetch() API
  • Stream 新增了 find()、toArray()、forEach()、some()、every() 方法
  • 取消标记 esm json 模块
  • NPM 更新至 8.4.1
  • node-api 添加 node_api_symbol_for() 方法

fetch API 支持

Node.js 核心引入 fetch API 是一个令人兴奋的功能,目前在 v17.5.0 版本为试验性支持,在今后的 LTS 版本中如果正式支持了,就不需要在依赖第三方 HTTP 请求库了。

Fetch API 提供了 WHATWG 标准接口获取资源,这是一个基于 Promise 的 HTTP 客户端,可以用来简化 HTTP 请求,在浏览器环境已支持,浏览器环境的兼容性实现参考 Web/API/fetch,使用方式与浏览器中使用 Fetch API 一致。

Fetch API 主要包含以下四个接口:

  • fetch():该方法是最常用的,用于发送请求。
  • Headers:相当于 response/request 的头信息,可以使你查询到这些头信息,或者针对不同的结果做不同的操作。
  • Request:相当于一个资源请求。
  • Response:相当于请求的响应。

一个简单的使用方式:

  1. const response = await fetch(url);
  2. console.log(response.ok);
  3. console.log(await response.json());

运行时需要加上 **--experimental-fetch** 标记,例如 node --experimental-fetch test.mjs

Node.js 中的 fetch() 实现基于 undici,该项目位于 Node.js Github 项目组织下,其中的几位贡献者也是 Node.js 项目的贡献者,致力于为 Node.js 开发快速、可靠且符合规范的 HTTP 客户端,比内置的 HTTP 模块还要快,因为它摒弃了原有的 HTTP 模块,直接构建在 socket 之上,可参见笔者之前写的这篇文章 request 已废弃 - 推荐一个超快的 Node.js HTTP Client undici

Stream 模块

Node.js v17.5.0 Stream 模块增加了 find()、toArray()、forEach()、some()、every() 方法,这一块可 参考官网 API#stream 介绍。

下面以 some() 方法为例,如果有任何大文件就返回 true。

  1. import { Readable } from 'stream';
  2. import { stat } from 'fs/promises';
  3. const anyBigFile = await Readable.from([
  4. 'file1',
  5. 'file2',
  6. 'file3',
  7. ]).some(async (fileName) => {
  8. const stats = await stat(fileName);
  9. return stats.size > 1024 * 1024;
  10. }, { concurrency: 2 });

注意:奇数版本不是长期支持版本,Node.js 版本信息参考 Node.js 版本知多少?又该如何选择?

Reference