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:相当于请求的响应。
一个简单的使用方式:
const response = await fetch(url);
console.log(response.ok);
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。
import { Readable } from 'stream';
import { stat } from 'fs/promises';
const anyBigFile = await Readable.from([
'file1',
'file2',
'file3',
]).some(async (fileName) => {
const stats = await stat(fileName);
return stats.size > 1024 * 1024;
}, { concurrency: 2 });
注意:奇数版本不是长期支持版本,Node.js 版本信息参考 Node.js 版本知多少?又该如何选择?。