Node APIs

cachedDataVersionTag and getHeapStatistics, serialize and deserialize are supported. setFlagsFromStrings is a noop. Other APIs are not supported and will throw and error.

setFlagsFromStrings: This function is a noop.

node:vm Jump to heading

measureMemory: This is a non-functional stub.

compile: The importModuleDynamically parameter is not supported.

createContext: The importModuleDynamically parameter is not supported.

Script: The importModuleDynamically parameter is not supported. The runInContext method does not support break on SIGINT.

node:worker_threads Jump to heading

parentPort: The emit method is not supported. The removeAllListeners method is not supported.

markAsUntransferable: This symbol is not supported.

moveMessagePortToContext: This symbol is not supported.

receiveMessageOnPort: This symbol is not supported.

Worker: The getHeapSnapshot method is not supported.

node:zlib Jump to heading

Options: This class is not supported.

BrotliOptions: This class is not supported.

BrotliCompress: This class is not supported.

BrotliDecompress: This class is not supported.

ZlibBase: This class is not supported.

Unsupported modules (6/44) Jump to heading

node:cluster Jump to heading

All exports are non-functional stubs.

All symbols: This symbol is a non-functional stub.

node:domain Jump to heading

All exports are non-functional stubs. This is a deprecated Node module.

All symbols: This symbol is a non-functional stub.

node:repl Jump to heading

All symbols are not supported.

All symbols: This symbol is not supported.

node:sea Jump to heading

All symbols are not supported.

All symbols: This symbol is not supported.

node:trace_events Jump to heading

All exports are non-functional stubs.

All symbols: This symbol is a non-functional stub.

node:wasi Jump to heading

All exports are non-functional stubs.

All symbols: This symbol is a non-functional stub.

全局变量 Jump to heading

这是 Deno 支持的 Node 全局变量列表。这些全局变量仅在 npm 包范围内可用。在您自己的代码中，您可以通过从相关的 node: 模块导入它们来使用它们。

Global name	Status
`AbortController`	✅
`AbortSignal`	✅
`Blob`	✅
`Buffer`	✅
`ByteLengthQueuingStrategy`	✅
`__dirname`	⚠️ 信息
`__filename`	⚠️ 信息
`atob`	✅
`BroadcastChannel`	✅
`btoa`	✅
`clearImmediate`	✅
`clearInterval`	✅
`clearTimeout`	✅
`CompressionStream`	✅
`console`	✅
`CountQueuingStrategy`	✅
`Crypto`	✅
`CryptoKey`	✅
`CustomEvent`	✅
`CustomEvent`	✅
`DecompressionStream`	✅
`Event`	✅
`EventTarget`	✅
`exports`	✅
`fetch`	✅
`File`	✅
`FormData`	✅
`global`	✅
`Headers`	✅
`MessageChannel`	✅
`MessageEvent`	✅
`MessagePort`	✅
`module`	✅
`PerformanceEntry`	✅
`PerformanceMark`	✅
`PerformanceMeasure`	✅
`PerformanceObserver`	✅
`PerformanceObserverEntryList`	❌
`PerformanceResourceTiming`	❌
`performance`	✅
`process`	✅
`queueMicrotask`	✅
`ReadableByteStreamController`	✅
`ReadableStream`	✅
`ReadableStreamBYOBReader`	✅
`ReadableStreamBYOBRequest`	✅
`ReadableStreamDefaultController`	✅
`ReadableStreamDefaultReader`	✅
`require`	✅
`Response`	✅
`Request`	✅
`setImmediate`	✅
`setInterval`	✅
`setTimeout`	✅
`structuredClone`	✅
`structuredClone`	✅
`SubtleCrypto`	✅
`DOMException`	✅
`TextDecoder`	✅
`TextDecoderStream`	✅
`TextEncoder`	✅
`TextEncoderStream`	✅
`TransformStream`	✅
`TransformStreamDefaultController`	✅
`URL`	✅
`URLSearchParams`	✅
`URLSearchParams`	✅
`WebAssembly`	✅
`WritableStream`	✅
`WritableStreamDefaultController`	✅
`WritableStreamDefaultWriter`	✅

`dirname` 和 `filename` Jump to heading

__dirname 和 __filename 是 CommonJS 全局变量。它们在 npm 包作用域内的 CommonJS 模块中可用，但在 ES 模块中未定义。在您自己的 ES 模块中，请改用 import.meta.dirname 和 import.meta.filename，它们为当前模块提供相同的值。

模块说明 Jump to heading

node:worker_threads Jump to heading

Deno 2.7 显著提升了 node:worker_threads 的兼容性：

stdout 和 stderr 流会从 worker 正确转发到父进程。
worker.terminate() 现在会以正确的退出码解析。
支持 workerData、execArgv 和 threadName 选项。
已实现 worker.performance.eventLoopUtilization() 和 worker.cpuUsage()。
来自 worker 线程的 BroadcastChannel 能正确进行 ref/unref。

node:child_process Jump to heading

Deno 2.7 提升了 node:child_process 的兼容性：

stdio 流（stdin、stdout、stderr）会作为 Socket 实例暴露，与 Node.js 行为一致。
Shell 重定向（>、<、>>）可在 exec() 和 execSync() 中正常工作。
fork() 接受 URL 作为模块路径。
timeout 和 killSignal 选项在 exec() 和 spawn() 中受到支持。
NODE_OPTIONS 环境变量会被 fork() 的子进程遵循。

node:zlib Jump to heading

Deno 2.7 为 node:zlib 添加了 Zstd 压缩支持：

import zlib from "node:zlib";
import { promisify } from "node:util";

const compress = promisify(zlib.zstdCompress);
const decompress = promisify(zlib.zstdDecompress);

const compressed = await compress(Buffer.from("你好，Deno！"));
const result = await decompress(compressed);
console.log(result.toString()); // "你好，Deno！"

同步版本 zlib.zstdCompressSync() 和 zlib.zstdDecompressSync() 也可用。

node:sqlite Jump to heading

Deno 2.7 为 node:sqlite 添加了多个新 API：

DatabaseSync.setAuthorizer(callback) — 注册一个回调，该回调会在每次 SQL 操作时被调用，从而能够对允许哪些表和操作进行细粒度访问控制：

import { constants, DatabaseSync } from "node:sqlite";

const db = new DatabaseSync(":memory:");
db.exec("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)");

// 允许读取，拒绝其他所有操作
db.setAuthorizer((_action, _table) => {
  return constants.SQLITE_OK;
});

DatabaseSync.enableDefensive(enabled) — 启用或禁用防御模式，该模式可阻止某些潜在危险的数据库操作，例如在运行时修改 schema。
DatabaseSync.createTagStore() — 创建一个预处理语句缓存，将 SQL 字符串映射到已编译语句，以便高效重复执行。

Node 测试结果 Jump to heading

如果您对逐个测试用例的兼容性有更详细的了解，您可以在此页面上找到通过和未通过的 Node.js 测试用例列表。

Fully supported modules (22/44) Jump to heading#

Partially supported modules (16/44) Jump to heading#

Unsupported modules (6/44) Jump to heading#

全局变量 Jump to heading#

__dirname 和 __filename Jump to heading#

模块说明 Jump to heading#

node:worker_threads Jump to heading#

node:child_process Jump to heading#

node:zlib Jump to heading#

node:sqlite Jump to heading#

Node 测试结果 Jump to heading#

Did you find what you needed?

Fully supported modules (22/44) Jump to heading

Partially supported modules (16/44) Jump to heading

Unsupported modules (6/44) Jump to heading

全局变量 Jump to heading

`dirname` 和 `filename` Jump to heading

模块说明 Jump to heading

node:worker_threads Jump to heading

node:child_process Jump to heading

node:zlib Jump to heading

node:sqlite Jump to heading

Node 测试结果 Jump to heading