Node18 支持 import HTTP资源

Posted 「零一」

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Node18 支持 import HTTP资源相关的知识,希望对你有一定的参考价值。

大家好,我是零一,最近看到Node官方提交了一条commit ,并且已经合入 master分支 ,如下图所示:

由此可见,Node18可能会支持一个非常 nice 的功能,那就是 支持 import 远程HTTPS资源和本地的HTTP资源,啥意思?看个例子🌰

尝鲜

现在有这样一个文件:

// demo.mjs
import sayHelloWorld from "https://example/say-helloWorld.mjs";

console.log(sayHelloWorld());

可以看到,这里选择加载了一个远程的HTTPS文件资源,该文件内容如下:

// say-helloWorld.mjs
export default function sayHelloWorld () 
  return 'Hello,World! 零一'

接下来运行一下 demo.mjs看看会发生什么,因为在Node18中,该功能属于实验性功能,所以我们需要加上参数 --experimental-network-imports 来启动该特性:

node --experimental-network-imports demo.mjs

运行结果:

// Hello,World! 零一

当然了,本地起的HTTP服务上的文件资源也是可以一样导入的,例如:

import sayHelloWorld from "http://10.59.24.2:8080/say-helloWorld.mjs"   // ok

注意

我们使用该特性导入的脚本资源文件有一个前提条件,那就是该文件所在的服务器上响应此文件请求的类型 content_type 必须为 application/javascript,否则就无法加载

我们可以用 curl 来查看一下想要加载的文件响应类型,例如:

$ curl -s -o /dev/null -w '%content_type' 'https://example/say-helloWorld.mjs'

# application/javascript

错误场景

  • ERR_NETWORK_IMPORT_BAD_RESPONSE:当导入的资源不存在时,即响应 404,就会报该错误
Error [ERR_NETWORK_IMPORT_BAD_RESPONSE]: import 'https://xxxx/xxxx' received a bad response: HTTP response returned status code of 404
  • ERR_NETWORK_IMPORT_DISALLOWED:当请求一个HTTPS资源且被重定向到一个非网络资源时,是不被允许的
Error [ERR_NETWORK_IMPORT_DISALLOWED]: import of 'ftp://xxxxx/say-helloWorld.mjs' by 'https://h3manth.com/foo.mjs' is not support: cannot redirect to non-network location
  • ERR_UNKNOWN_MODULE_FORMAT:当请求的资源不是 ESM 时,会报该错误
RangeError [ERR_UNKNOWN_MODULE_FORMAT]: Unknown module format: null for URL https://xxxxxx/say-helloWorld.js
  • ERR_UNSUPPORTED_ESM_URL_SCHEME:当加载的资源URL的协议不被支持时,会报该错误,例如 ftp:
Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, https, http are supported by the default ESM loader. Received protocol 'ftp:'

实现原理

其实原理也比较简单:

先调用 fetchModule 方法检查资源模块是否缓存过(cacheForGET

function fetchModule(parsed,  parentURL ) 
  const  href  = parsed;
  const existing = cacheForGET.get(href);
  if (existing) 
    return existing;
  
  if (parsed.protocol === 'http:') 
    return PromisePrototypeThen(isLocalAddress(parsed.hostname), (is) => 
      // Makes few checks for ERR_NETWORK_IMPORT_DISALLOWED
      return fetchWithRedirects(parsed);
    );
  
  return fetchWithRedirects(parsed);

若没有缓存,则调用 fetchWithRedirects

function fetchWithRedirects(parsed) 
  const existing = cacheForGET.get(parsed.href);
  if (existing) 
    return existing;
  
  const handler = parsed.protocol === 'http:' ? HTTPGet : HTTPSGet;
  const result = new Promise((fulfill, reject) => 
    const req = handler(parsed, 
      headers: 
        Accept: '*/*'
      
    )
    .on('error', reject)
    .on('response', (res) => 
      // 错误检查
      // 缓存内容
      // 返回模块内容
    

然后根据资源类型去调用不同的方法(HTTPGetHTTPSGet

let HTTPSAgent;
function HTTPSGet(url, opts) 
  const https = require('https'); // For HTTPGet, we use the `http` builtin
  HTTPSAgent ??= new https.Agent(
    keepAlive: true
  );
  return https.get(url, 
    agent: HTTPSAgent,
    ...opts
  );

总结

这个功能还是很香的,谁用谁知道,但目前有一些缺点:

  1. 实验性功能,可能还会改动,而且使用需要加参数 --experimental-network-imports
  2. 本地只支持 http,一旦涉及到 https 就很淡疼
  3. 该功能的代码实现就限制死了只支持 http:https:,其它一概不支持

希望本文对你们有所帮助~

我是零一,分享技术,不止前端,我们下期见~

以上是关于Node18 支持 import HTTP资源的主要内容,如果未能解决你的问题,请参考以下文章

Node18 支持 import HTTP资源

Node18 支持 import HTTP资源

Node18 支持 import HTTP资源

Unity自定义资源导入器(unity实验性功能)

最新版本的 node.js 支持 ES7 import/export 吗?怎么开启

node 环境下一个文件如何同时支持 import 和 require