Node.js v17.6.0 发布,允许从 HTTP 和 HTTPS URL 导入模块

2022-04-06 12:16:43 浏览数 (1)

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 标志。

代码语言:javascript复制
// 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 所添加,该方法返回事件循环活动状态的资源类型。

代码语言:javascript复制
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 -

0 人点赞