简中文档
On this page

动态导入

Deno Deploy 支持 动态导入 ,但有一些限制。本文概述了这些限制。

规范符必须是静态确定的字符串字面量 Jump to heading

在普通的动态导入中,规范符不需要在构建时确定。因此以下所有形式都是有效的:

Deno CLI 中有效的动态导入
// 1. 静态确定的字符串字面量
await import("jsr:@std/assert");

// 2. 静态确定,但通过变量
const specifier = "jsr:@std/assert";
await import(specifier);

// 3. 静态确定,但模板字面量
const stdModuleName = "path";
await import(`jsr:@std/${stdModuleName}`);

// 4. 动态确定
const rand = Math.random();
const mod = rand < 0.5 ? "npm:cowsay" : "npm:node-emoji";
await import(mod);

然而,在 Deno Deploy 中,规范符必须是没有字符串插值的字符串字面量。因此在上述三个例子中,只有第一个在 Deno Deploy 中有效。

仅静态字符串字面量在 Deno Deploy 中有效
// 1. ✅ 在 Deno Deploy 中正常工作
await import("jsr:@std/assert");

// 2. ❌ 在 Deno Deploy 中不工作
// 因为传递给 `import` 的是一个变量
const specifier = "jsr:@std/streams";
await import(specifier);

// 3. ❌ 在 Deno Deploy 中不工作
// 因为这有一个插值
const stdModuleName = "path";
await import(`jsr:@std/${stdModuleName}`);

// 4. ❌ 在 Deno Deploy 中不工作
// 因为这是动态的
const rand = Math.random();
const mod = rand < 0.5 ? "npm:cowsay" : "npm:node-emoji";
await import(mod);

一个例外 - 动态规范符适用于同项目文件 Jump to heading

如果目标文件(模块)包含在同一个项目中,动态确定的规范符是支持的。

动态规范符适用于同项目中的文件
// ✅ 在 Deno Deploy 中正常工作
await import("./my_module1.ts");

// ✅ 在 Deno Deploy 中正常工作
const rand = Math.random();
const modPath = rand < 0.5 ? "dir1/moduleA.ts" : "dir2/dir3/moduleB.ts";
await import(`./${modPath}`);

请注意,以 ./ 开头的模板字面量告诉模块解析器目标模块在同一个项目中。相反,如果规范符不以 ./ 开头,可能的目标模块将不会包含在生成的 eszip 中,这将导致动态导入在运行时失败,即使最终评估的规范符以 ./ 开头。

// ❌ 不工作,因为分析器无法静态确定此情况下的规范符是否以 `./` 开头。
// 与之前的例子相比,唯一的区别是是否在模板字面量中或在变量中放置 `./`。
const rand = Math.random();
const modPath = rand < 0.5 ? "./dir1/moduleA.ts" : "./dir2/dir3/moduleB.ts";
await import(modPath);

我们将考虑是否可以在未来放宽这一约束。

什么是 eszip?

当您在 Deno Deploy 上进行新部署时,系统会分析您的代码,通过递归遍历构建模块图,并将所有依赖项打包到一个单独的文件中。我们称之为 eszip。由于其创建是完全静态完成的,因此 Deno Deploy 上的动态导入功能受到限制。

数据 URL Jump to heading

数据 URL 可以用作传递给动态导入的规范符。

静态数据 URL
// ✅ 在 Deno Deploy 中正常工作
const { val } = await import(
  "data:text/javascript,export const val = 42;"
);
console.log(val); // -> 42

对于数据 URL,完全动态的数据是支持的。

动态数据 URL
function generateDynamicDataUrl() {
  const moduleStr = `export const val = ${Math.random()};`;
  return `data:text/javascript,${moduleStr}`;
}

// ✅ 在 Deno Deploy 中正常工作
const { val } = await import(generateDynamicDataUrl());
console.log(val); // -> 打印随机值

将此技术应用于从网络获取的 JavaScript 代码,您甚至可以模拟真正的动态导入:

external.js
export const name = "external.js";
从获取的源生成的动态数据 URL
import { assert } from "jsr:@std/assert/assert";
const res = await fetch(
  "https://gist.githubusercontent.com/magurotuna/1cacb136f9fd6b786eb8bbad92c8e6d6/raw/56a96fd0d246fd3feabbeecea6ea1155bdf5f50d/external.js",
);
assert(res.ok);
const src = await res.text();
const dataUrl = `data:application/javascript,${src}`;

// ✅ 在 Deno Deploy 中正常工作
const { name } = await import(dataUrl);
console.log(`来自 ${name} 的问候`); // -> "来自 external.js 的问候"

然而,请注意传递给 import 的数据 URL 必须是 JavaScript;如果传递 TypeScript,将在运行时抛出 TypeError

你找到了你需要的东西吗?

编辑此页面
隐私政策