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
标志。
// hello.mjs
export default function hello(message) {
console.log(`Hello ${message}`);
}
$ http-server
Starting up http-server, serving ./
Available on:
http://127.0.0.1:8080
// index.mjs
import hello from 'http://127.0.0.1:8080/hello.mjs';
console.log(hello('codingMay')); // Hello codingMay
当前并非所有的 ES Modules 模块都可以加载,以下两个 Example,第一个尽管是加载的 HTTPS 资源,但不是 HTTP/1,Example 2 导入了非网络依赖资源。
代码语言:javascript复制// Example1: 加载 HTTPS 资源
import hello from 'https://gitee.com/qufei1993/esmodule-https-import-example/blob/master/hello.mjs';
console.log(hello('codingMay'));
输出错误:RangeError [ERR_UNKNOWN_MODULE_FORMAT]: Unknown module format: null for URL https://gitee.com/qufei1993/esmodule-https-import-example/blob/master/hello.mjs
// Example2: 加载其它非网络资源
// hello.mjs
import fsPromise from 'fs/promises';
export const readFile = filename => fsPromise.readFile(filename);
// index.mjs
import hello from 'http://127.0.0.1:8080/hello.mjs';
输出错误: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 所添加,该方法返回事件循环活动状态的资源类型。
import { getActiveResourcesInfo } from 'process';
import { createServer } from 'http';
console.log('Before:', getActiveResourcesInfo()); // Before: [ 'CloseReq', 'TTYWrap', 'TTYWrap', 'TTYWrap' ]
setTimeout(() => {
console.log('After:', getActiveResourcesInfo()); // After: [ 'TTYWrap', 'TTYWrap', 'TTYWrap', 'TCPServerWrap', 'Timeout' ]
}, 5000);
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
- https://itnext.io/importing-an-es6-modules-over-http-https-in-a-node-js-225ffba8c3fc
- https://nodejs.org/en/blog/release/v17.6.0/
- https://nodejs.org/dist/latest-v17.x/docs/api/esm.html#https-and-http-imports
- END -