不稳定的特性标志

Deno 运行时的新功能通常在特性标志后发布，因此用户可以在新 API 和功能最终确定之前试用它们。当前不稳定的特性标志在此页面上列出，也可以通过运行以下命令在 CLI 帮助文本中找到

deno --help

在命令行中使用标志 跳转到标题#

当您从命令行运行 Deno 程序时，可以通过将标志作为 CLI 的选项传入来启用特性标志。以下是使用 --unstable-node-globals 标志启用的程序示例

deno run --unstable-node-globals main.ts

在 deno.json 中配置标志 跳转到标题#

您可以使用 deno.json 中的配置选项 指定要为您的项目启用的不稳定特性。

{
  "unstable": ["bare-node-builtins", "webgpu"]
}

unstable 数组中的可能值是删除了 --unstable- 前缀的标志名称。

通过环境变量配置 跳转到标题#

某些标志可以通过为给定名称的环境变量设置值（任何值）来启用，而不是作为标志或 deno.json 配置选项传递。可以通过环境变量设置的标志将在下面注明。

以下是通过环境变量设置 --unstable-bare-node-builtins 标志的示例

export DENO_UNSTABLE_BARE_NODE_BUILTINS=true

--unstable-bare-node-builtins 跳转到标题#

环境变量： DENO_UNSTABLE_BARE_NODE_BUILTINS

此标志使您能够导入 Node.js 内置模块，而无需 node: 说明符，如下例所示。如果您手动管理 Node.js 依赖项（请参阅 byonm 标志），您也可以使用此标志来启用 npm 包，而无需 npm: 说明符。

import { readFileSync } from "fs";

console.log(readFileSync("deno.json", { encoding: "utf8" }));

--unstable-detect-cjs 跳转到标题#

环境变量： DENO_UNSTABLE_DETECT_CJS

在以下附加场景中，将 .js、.jsx、.ts 和 .tsx 模块加载为可能是 CommonJS

1. package.json 没有 "type" 字段。
2. 不存在 package.json。

默认情况下，仅当您在具有 package.json 的项目中并且最近的 package.json 具有 { "type": "commonjs" } 时，Deno 才会将这些模块加载为可能是 CommonJS。

需要 Deno >= 2.1.2

--unstable-node-globals 跳转到标题#

此标志将 Node 特定的全局变量注入到全局作用域中。注入的全局变量是

• Buffer
• global
• setImmediate
• clearImmediate

请注意，从 Deno 2.0 开始，process 已经作为全局变量可用。

需要 Deno >= 2.1.0

--unstable-sloppy-imports 跳转到标题#

环境变量： DENO_UNSTABLE_SLOPPY_IMPORTS

此标志启用了一种行为，该行为将从不包含文件扩展名的导入中推断出文件扩展名。通常，以下 import 语句会产生错误

import { Example } from "./bar";
console.log(Example);

export const Example = "Example";

使用启用宽松导入的脚本执行将消除错误，但会提供应使用更高效语法的指导。

宽松导入将允许（但会打印警告）以下内容

• 从导入中省略文件扩展名
• 使用不正确的文件扩展名（例如，当实际文件为 .ts 时，使用 .js 扩展名导入）
• 导入目录路径，并自动使用 index.js 或 index.ts 作为该目录的导入

deno compile 不支持宽松导入。

--unstable-unsafe-proto 跳转到标题#

Deno 出于安全原因，有意识地决定不支持 Object.prototype.__proto__。但是，仍然有许多 npm 包依赖此属性才能正常工作。

此标志启用此属性。请注意，不建议使用此属性，但如果您确实需要使用依赖它的包，现在可以使用此应急方案。

--unstable-webgpu 跳转到标题#

在全局作用域中启用 WebGPU API，就像在浏览器中一样。以下是使用此 API 获取有关 GPU 基本信息的简单示例

// Try to get an adapter from the user agent.
const adapter = await navigator.gpu.requestAdapter();
if (adapter) {
  // Print out some basic details about the adapter.
  const adapterInfo = await adapter.requestAdapterInfo();

  // On some systems this will be blank...
  console.log(`Found adapter: ${adapterInfo.device}`);

  // Print GPU feature list
  const features = [...adapter.features.values()];
  console.log(`Supported features: ${features.join(", ")}`);
} else {
  console.error("No adapter found");
}

查看 此存储库 以获取更多使用 WebGPU 的示例。

--unstable-broadcast-channel 跳转到标题#

启用此标志使 BroadcastChannel Web API 可在全局作用域中使用，就像在浏览器中一样。

--unstable-worker-options 跳转到标题#

启用不稳定的 Web Worker API 选项。具体来说，它使您可以指定可用于 worker 的权限

new Worker(`data:application/javascript;base64,${btoa(`postMessage("ok");`)}`, {
  type: "module",
  deno: {
    permissions: {
      read: true,
    },
  },
}).onmessage = ({ data }) => {
  console.log(data);
};

--unstable-cron 跳转到标题#

启用此标志使 Deno.cron API 在 Deno 命名空间中可用。

--unstable-kv 跳转到标题#

启用此标志使 Deno KV API 在 Deno 命名空间中可用。

--unstable-net 跳转到标题#

在 Deno 命名空间中启用不稳定的 net API。这些 API 包括

• Deno.DatagramConn

--unstable-otel 跳转到标题#

为 Deno 启用 OpenTelemetry 集成。

--unstable 跳转到标题#

在较新的 Deno 版本（1.38+）之前，不稳定 API 通过使用 --unstable 标志一次性提供。值得注意的是，Deno KV 和其他云原生 API 可在此标志后使用。要运行有权访问这些不稳定功能的程序，您可以使用以下命令运行脚本

deno run --unstable your_script.ts

建议您使用细粒度不稳定标志来代替此标志，--unstable 标志现已弃用，并将在 Deno 2 中删除。