Node.js load(url, context, defaultLoad)用法及代碼示例

load(url, context, defaultLoad)

• url <string>
• context <Object>
  • format <string> | <null> | <undefined> resolve 鉤子可選提供的格式。
  • importAssertions <Object>
• defaultLoad <Function>
• 返回：<Object>
  • format <string>
  • source <string> | <ArrayBuffer> | <TypedArray>

load 鉤子提供了一種方法來定義自定義方法來確定應如何解釋、檢索和解析 URL。它還負責驗證導入斷言。

format 的最終值必須是以下之一：

format	說明	load 返回的 source 的可接受類型
'builtin'	加載 Node.js 內置模塊	不適用
'commonjs'	加載一個 Node.js CommonJS 模塊	不適用
'json'	加載 JSON 文件	{ string , ArrayBuffer , TypedArray }
'module'	加載一個 ES 模塊	{ string , ArrayBuffer , TypedArray }
'wasm'	加載 WebAssembly 模塊	{ ArrayBuffer , TypedArray }

source 的值對於類型 'builtin' 被忽略，因為目前無法替換 Node.js 內置(核心)模塊的值。 source 的值對於類型 'commonjs' 被忽略，因為 CommonJS 模塊加載器沒有為 ES 模塊加載器提供覆蓋 CommonJS module return value 的機製。未來可能會克服這一限製。

• 特定的 ArrayBuffer 對象是 SharedArrayBuffer 。
• 特定的 TypedArray 對象是 Uint8Array 。

如果基於文本的格式(即 'json' 、 'module' )的源值不是字符串，則使用 util.TextDecoder 將其轉換為字符串。

load 鉤子提供了一種方法來定義自定義方法來檢索 ES 模塊說明符的源代碼。這將允許加載程序潛在地避免從磁盤讀取文件。它還可用於將無法識別的格式映射到受支持的格式，例如 yaml 到 module 。

/**
 * @param {string} url
 * @param {{
    format: string,
  }} context If resolve settled with a `format`, that value is included here.
 * @param {Function} defaultLoad
 * @returns {Promise<{
    format: string,
    source: string | ArrayBuffer | SharedArrayBuffer | Uint8Array,
  }>}
 */
export async function load(url, context, defaultLoad) {
  const { format } = context;
  if (Math.random() > 0.5) { // Some condition.
    /*
      For some or all URLs, do some custom logic for retrieving the source.
      Always return an object of the form {
        format: <string>,
        source: <string|buffer>,
      }.
    */
    return {
      format,
      source: '...',
    };
  }
  // Defer to Node.js for all other URLs.
  return defaultLoad(url, context, defaultLoad);
}

在更高級的場景中，這也可用於將不受支持的源轉換為受支持的源(參見下麵的Examples)。