默认标题_公众号封面首图_2022-03-01+22_26_42.png
Node.js v17.6.0 版本于 2022-02-23 发布，一个显著的特性是试验性支持从 HTTP 和 HTTPS 导入模块，这里面也包括很多问题，包括从安全方面考虑，目前在 Node.js 中使用还是有一些限制。及一些其它的常规小错误修复。

允许从 HTTP 和 HTTPS URL 导入模块

Node.js v17.6.0 一个新的实验性功能是允许我们从 HTTP 或 HTTPS URL 导入 ES Module。这使得一些类似于 Web 浏览器导入的工作也可以在 Node.js 中完成，同时也消除了一些 Node.js 与 Deno 之间的差异，即 Deno 允许使用 HTTPS 导入包。因为一些安全性和稳定性的问题和浏览器相比还是有些差异的。

以下是一个导入 HTTP 资源的简单示例，该功能现在处于实验性状态，运行时需添加 --experimental-network-imports 标志。

  1. // hello.mjs
  2. export default function hello(message) {
  3.   console.log(`Hello ${message}`); 
  4. }
  6. $ http-server
  7. Starting up http-server, serving ./
  8. Available on:
  9.   http://127.0.0.1:8080
  11. // index.mjs
  12. import hello from 'http://127.0.0.1:8080/hello.mjs'; 
  13. console.log(hello('codingMay')); // Hello codingMay

当前并非所有的 ES Modules 模块都可以加载，以下两个 Example，第一个尽管是加载的 HTTPS 资源，但不是 HTTP/1，Example 2 导入了非网络依赖资源。

  1. // Example1: 加载 HTTPS 资源
  2. import hello from 'https://gitee.com/qufei1993/esmodule-https-import-example/blob/master/hello.mjs';
  3. console.log(hello('codingMay'));
  6. 输出错误：RangeError [ERR_UNKNOWN_MODULE_FORMAT]: Unknown module format: null for URL https://gitee.com/qufei1993/esmodule-https-import-example/blob/master/hello.mjs
  8. // Example2: 加载其它非网络资源
  9. // hello.mjs
  10. import fsPromise from 'fs/promises';
  11. export const readFile = filename => fsPromise.readFile(filename);
  13. // index.mjs
  14. import hello from 'http://127.0.0.1:8080/hello.mjs'; 
  16. 输出错误：TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file

HTTP 和 HTTPS 导入的一些限制：

  • 仅支持 HTTP/1，不支持 HTTP2/HTTP3。
  • HTTP 仅限于环回地址。
  • 身份验证不会发至服务器，例如 Authorization、Cookie 和 Proxy-Authorization 标头不会发送到服务。
  • 永远不会在目标服务器上检查 CORS。
  • 无法加载非网络依赖项。
  • 默认情况下不启用基于网络的加载，需要通过--experimental-network-imports 标志打开加载 HTTP 或 HTTPS 资源。

Process 获取活跃具柄和请求方法废弃通知

这个改变主要是在文档记录了 _getActiveHandles 和 _getActiveRequests 的弃用通知，以便支持更好的公共 API。

这两个以下划线开头的 API 被代替的公共 API 方法 process.getActiveResourcesInfo() 在 Node.js v17.3.0 所添加，该方法返回事件循环活动状态的资源类型。

  1. import { getActiveResourcesInfo } from 'process';
  2. import { createServer } from 'http';
  4. console.log('Before:', getActiveResourcesInfo()); // Before: [ 'CloseReq', 'TTYWrap', 'TTYWrap', 'TTYWrap' ]
  5. setTimeout(() => {
  6.   console.log('After:', getActiveResourcesInfo()); // After: [ 'TTYWrap', 'TTYWrap', 'TTYWrap', 'TCPServerWrap', 'Timeout' ]
  7. }, 5000);
  9. createServer((req, res) => res.end('OK')).listen(3000);

其它的一些升级事项

  • stream：恢复 map 规范合规性。
  • build：移除损坏的 x32 arch 支持。
  • fetch：当 fetch 启用时（--experimental-fetch），global 对象添加 FormData。
  • fs：cp 和 cpSync 支持相对链接复制。
  • process: 废弃 multipleResolves。
  • deps: 更新 npm 到 8.5.1。

Reference