Node.js v26.0.0 文档

错误#

在 Node.js 中运行的应用程序通常会遇到以下类别的错误：

• 标准 JavaScript 错误，例如 <EvalError>、<SyntaxError>、<RangeError>、<ReferenceError>、<TypeError> 和 <URIError>。
• 标准 DOMException。
• 由底层操作系统约束触发的系统错误，例如尝试打开不存在的文件或尝试通过已关闭的套接字发送数据。
• AssertionError 是一类特殊的错误，当 Node.js 检测到不应发生的逻辑违规时可能会触发。这些错误通常由 node:assert 模块引发。
• 由应用程序代码触发的用户指定错误。

由 Node.js 引发的所有 JavaScript 和系统错误都继承自或属于标准 JavaScript <Error> 类，并保证至少提供该类上可用的属性。

Node.js 引发的错误的 error.message 属性在任何版本中都可能发生变化。请使用 error.code 来识别错误。对于 DOMException，请使用 domException.name 来识别其类型。

错误传播与拦截#

Node.js 支持多种机制来传播和处理应用程序运行时发生的错误。这些错误的报告和处理方式完全取决于 Error 的类型以及所调用的 API 风格。

所有 JavaScript 错误都作为异常处理，使用标准的 JavaScript throw 机制立即生成并抛出错误。这些错误可以使用 JavaScript 语言提供的 try…catch 结构来处理。

// Throws with a ReferenceError because z is not defined.
try {
  const m = 1;
  const n = m + z;
} catch (err) {
  // Handle the error here.
}
copy

任何对 JavaScript throw 机制的使用都会引发一个必须被处理的异常，否则 Node.js 进程将立即退出。

除了少数例外，同步 API（任何不返回 <Promise> 也不接受 callback 函数的阻塞方法，例如 fs.readFileSync）将使用 throw 来报告错误。

在 异步 API 中发生的错误可以通过多种方式报告：

• 某些异步方法返回一个 <Promise>，您应始终考虑到它可能会被拒绝。有关进程如何响应未处理的 promise 拒绝，请参阅 --unhandled-rejections 标志。

  const fs = require('node:fs/promises');
  
  (async () => {
    let data;
    try {
      data = await fs.readFile('a file that does not exist');
    } catch (err) {
      console.error('There was an error reading the file!', err);
      return;
    }
    // Otherwise handle the data
  })();
  copy

• 大多数接受 callback 函数的异步方法都会接受一个作为该函数第一个参数传递的 Error 对象。如果该第一个参数不是 null 并且是 Error 的实例，则说明发生了应该处理的错误。

  const fs = require('node:fs');
  fs.readFile('a file that does not exist', (err, data) => {
    if (err) {
      console.error('There was an error reading the file!', err);
      return;
    }
    // Otherwise handle the data
  });
  copy

• 当在作为 EventEmitter 的对象上调用异步方法时，错误可以路由到该对象的 'error' 事件。

  const net = require('node:net');
  const connection = net.connect('localhost');
  
  // Adding an 'error' event handler to a stream:
  connection.on('error', (err) => {
    // If the connection is reset by the server, or if it can't
    // connect at all, or on any sort of error encountered by
    // the connection, the error will be sent here.
    console.error(err);
  });
  
  connection.pipe(process.stdout);
  copy

• Node.js API 中少数典型的异步方法可能仍然使用 throw 机制来引发必须使用 try…catch 处理的异常。此类方法没有完整的列表；请参考每个方法的文档以确定所需的适当错误处理机制。

'error' 事件机制的使用对于 基于流 和 基于事件触发器 的 API 最为常见，它们本身代表了一系列随时间发生的异步操作（而不是可能成功或失败的单个操作）。

对于所有 EventEmitter 对象，如果没有提供 'error' 事件处理器，错误将被抛出，导致 Node.js 进程报告未捕获的异常并崩溃，除非：已经为 'uncaughtException' 事件注册了处理器，或者使用了已弃用的 node:domain 模块。

const EventEmitter = require('node:events');
const ee = new EventEmitter();

setImmediate(() => {
  // This will crash the process because no 'error' event
  // handler has been added.
  ee.emit('error', new Error('This will crash'));
});
copy

以这种方式生成的错误无法使用 try…catch 拦截，因为它们是在调用代码已经退出之后被抛出的。

开发人员必须查阅每个方法的文档，以确定这些方法引发的错误是如何传播的。

类: Error#

一个通用的 JavaScript <Error> 对象，它不表示错误发生的任何具体情况。Error 对象捕获一个“堆栈跟踪”，详细说明了代码中实例化 Error 的点，并可以提供错误的文本描述。

由 Node.js 生成的所有错误（包括所有系统错误和 JavaScript 错误）要么是 Error 类的实例，要么继承自该类。

new Error(message[, options])#

• message <string>
• options <Object>
• cause <any> 导致新创建错误的原因错误。

创建一个新的 Error 对象并将 error.message 属性设置为提供的文本消息。如果 message 传入的是一个对象，文本消息将通过调用 String(message) 生成。如果提供了 cause 选项，它将被赋值给 error.cause 属性。error.stack 属性将表示代码中调用 new Error() 的位置。堆栈跟踪依赖于 V8 的堆栈跟踪 API。堆栈跟踪仅延伸至 (a) 同步代码执行的开头，或 (b) 由 Error.stackTraceLimit 属性给出的帧数，以两者中较小者为准。

Error.captureStackTrace(targetObject[, constructorOpt])#

• targetObject <Object>
• constructorOpt <Function>

在 targetObject 上创建一个 .stack 属性，当访问该属性时，它返回一个字符串，表示代码中调用 Error.captureStackTrace() 的位置。

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`
copy

跟踪的第一行将以 ${myObject.name}: ${myObject.message} 为前缀。

可选的 constructorOpt 参数接受一个函数。如果给定，constructorOpt 之上的所有帧（包括 constructorOpt 本身）都将从生成的堆栈跟踪中省略。

constructorOpt 参数对于向用户隐藏错误生成的实现细节很有用。例如：

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
copy

Error.stackTraceLimit#

• 类型：<number>

Error.stackTraceLimit 属性指定堆栈跟踪收集的堆栈帧数量（无论是通过 new Error().stack 还是 Error.captureStackTrace(obj) 生成）。

默认值为 10，但可以设置为任何有效的 JavaScript 数字。更改将影响在该值被更改之后捕获的任何堆栈跟踪。

如果设置为非数字值或设置为负数，堆栈跟踪将不会捕获任何帧。

error.cause#

• 类型：<any>

如果存在，error.cause 属性是 Error 的根本原因。它用于在捕获错误并抛出带有不同消息或代码的新错误时，以便仍然可以访问原始错误。

error.cause 属性通常通过调用 new Error(message, { cause }) 来设置。如果未提供 cause 选项，它不会由构造函数设置。

此属性允许链接错误。在序列化 Error 对象时，util.inspect() 会在设置 error.cause 时递归地序列化它。

const cause = new Error('The remote HTTP server responded with a 500 status');
const symptom = new Error('The message failed to send', { cause });

console.log(symptom);
// Prints:
//   Error: The message failed to send
//       at REPL2:1:17
//       at Script.runInThisContext (node:vm:130:12)
//       ... 7 lines matching cause stack trace ...
//       at [_line] [as _line] (node:internal/readline/interface:886:18) {
//     [cause]: Error: The remote HTTP server responded with a 500 status
//         at REPL1:1:15
//         at Script.runInThisContext (node:vm:130:12)
//         at REPLServer.defaultEval (node:repl:574:29)
//         at bound (node:domain:426:15)
//         at REPLServer.runBound [as eval] (node:domain:437:12)
//         at REPLServer.onLine (node:repl:902:10)
//         at REPLServer.emit (node:events:549:35)
//         at REPLServer.emit (node:domain:482:12)
//         at [_onLine] [as _onLine] (node:internal/readline/interface:425:12)
//         at [_line] [as _line] (node:internal/readline/interface:886:18)
copy

error.code#

• 类型：<string>

error.code 属性是一个标识错误类型的字符串标签。error.code 是识别错误最稳定的方式。它只会在 Node.js 的主要版本之间更改。相比之下，error.message 字符串在 Node.js 的任何版本之间都可能发生变化。有关特定代码的详细信息，请参阅 Node.js 错误代码。

error.message#

• 类型：<string>

error.message 属性是通过调用 new Error(message) 设置的错误字符串描述。传递给构造函数的 message 也会出现在 Error 堆栈跟踪的第一行，但是 Error 对象创建后更改此属性可能不会更改堆栈跟踪的第一行（例如，当在更改此属性之前读取 error.stack 时）。

const err = new Error('The message');
console.error(err.message);
// Prints: The message
copy

error.stack#

• 类型：<string>

error.stack 属性是一个描述实例化 Error 的代码点的字符串。

Error: Things keep happening!
   at /home/gbusey/file.js:525:2
   at Frobnicator.refrobulate (/home/gbusey/business-logic.js:424:21)
   at Actor.<anonymous> (/home/gbusey/actors.js:400:8)
   at increaseSynergy (/home/gbusey/actors.js:701:6)
copy

第一行格式化为 <错误类名>: <错误消息>，后跟一系列堆栈帧（每行以 "at " 开头）。每个帧描述了导致错误生成的代码中的调用点。V8 尝试为每个函数显示一个名称（通过变量名、函数名或对象方法名），但有时它无法找到合适的名称。如果 V8 无法确定函数名称，则该帧仅显示位置信息。否则，确定的函数名称将显示在括号内，并附加位置信息。

仅为 JavaScript 函数生成帧。如果例如执行同步通过名为 cheetahify 的 C++ 插件函数，而该函数本身调用了 JavaScript 函数，则表示 cheetahify 调用的帧将不会出现在堆栈跟踪中。

const cheetahify = require('./native-binding.node');

function makeFaster() {
  // `cheetahify()` *synchronously* calls speedy.
  cheetahify(function speedy() {
    throw new Error('oh no!');
  });
}

makeFaster();
// will throw:
//   /home/gbusey/file.js:6
//       throw new Error('oh no!');
//           ^
//   Error: oh no!
//       at speedy (/home/gbusey/file.js:6:11)
//       at makeFaster (/home/gbusey/file.js:5:3)
//       at Object.<anonymous> (/home/gbusey/file.js:10:1)
//       at Module._compile (module.js:456:26)
//       at Object.Module._extensions..js (module.js:474:10)
//       at Module.load (module.js:356:32)
//       at Function.Module._load (module.js:312:12)
//       at Function.Module.runMain (module.js:497:10)
//       at startup (node.js:119:16)
//       at node.js:906:3
copy

位置信息将是以下之一：

• native，如果该帧表示对 V8 内部的调用（如 [].forEach）。
• plain-filename.js:line:column，如果该帧表示对 Node.js 内部的调用。
• /absolute/path/to/file.js:line:column，如果该帧表示对用户程序（使用 CommonJS 模块系统）或其依赖项的调用。
• <transport-protocol>:///url/to/module/file.mjs:line:column，如果该帧表示对用户程序（使用 ES 模块系统）或其依赖项的调用。

堆栈跟踪捕获的帧数受限于 Error.stackTraceLimit 或当前事件循环周期上可用帧数中的较小者。

error.stack 是一个隐藏内部属性的 getter/setter，仅存在于内置 Error 对象上（即 Error.isError 返回 true 的对象）。如果 error 不是内置错误对象，则 error.stack getter 将始终返回 undefined，且 setter 不会执行任何操作。如果访问器使用非内置错误对象的 this 值（例如 <Proxy>）手动调用，则可能会发生这种情况。

类: AssertionError#

• 继承: <errors.Error>

表示断言失败。有关详细信息，请参阅 类: assert.AssertionError。

类: RangeError#

• 继承: <errors.Error>

表示提供的参数不在函数的预期值集合或范围内；无论是数值范围，还是给定函数参数的选项集之外。

require('node:net').connect(-1);
// Throws "RangeError: "port" option should be >= 0 and < 65536: -1"
copy

Node.js 将作为参数验证的一种形式立即生成并抛出 RangeError 实例。

类: ReferenceError#

• 继承: <errors.Error>

表示正在尝试访问未定义的变量。此类错误通常表明代码中存在拼写错误或其他损坏的程序。

虽然客户端代码可能会生成并传播这些错误，但在实践中，通常只有 V8 会这样做。

doesNotExist;
// Throws ReferenceError, doesNotExist is not a variable in this program.
copy

除非应用程序正在动态生成和运行代码，否则 ReferenceError 实例表示代码或其依赖项中存在错误。

类: SyntaxError#

• 继承: <errors.Error>

表示程序不是有效的 JavaScript。这些错误仅能作为代码评估的结果生成和传播。代码评估可能由于 eval、Function、require 或 vm 而发生。这些错误几乎总是表明程序已损坏。

try {
  require('node:vm').runInThisContext('binary ! isNotOk');
} catch (err) {
  // 'err' will be a SyntaxError.
}
copy

SyntaxError 实例在创建它们的上下文中是不可恢复的——它们只能被其他上下文捕获。

类: SystemError#

• 继承: <errors.Error>

Node.js 在其运行时环境中发生异常时会生成系统错误。这些通常发生在应用程序违反操作系统约束时。例如，如果应用程序尝试读取不存在的文件，则会发生系统错误。

• address <string> 如果存在，指网络连接失败的地址。
• code <string> 字符串错误代码。
• dest <string> 如果存在，指报告文件系统错误时的目标文件路径。
• errno <number> 系统提供的错误编号。
• info <Object> 如果存在，指关于错误条件的额外详细信息。
• message <string> 系统提供的人类可读错误描述。
• path <string> 如果存在，指报告文件系统错误时的文件路径。
• port <number> 如果存在，指不可用的网络连接端口。
• syscall <string> 触发错误的系统调用名称。

error.address#

• 类型：<string>

如果存在，error.address 是描述网络连接失败地址的字符串。

error.code#

• 类型：<string>

error.code 属性是表示错误代码的字符串。

error.dest#

• 类型：<string>

如果存在，error.dest 是报告文件系统错误时的目标文件路径。

error.errno#

• 类型：<number>

error.errno 属性是一个负数，对应于 libuv 错误处理 中定义的错误代码。

在 Windows 上，系统提供的错误编号将由 libuv 标准化。

要获取错误代码的字符串表示形式，请使用 util.getSystemErrorName(error.errno)。

error.info#

• 类型：<Object>

如果存在，error.info 是包含错误条件详情的对象。

error.message#

• 类型：<string>

error.message 是系统提供的人类可读错误描述。

error.path#

• 类型：<string>

如果存在，error.path 是包含相关无效路径名的字符串。

error.port#

• 类型：<number>

如果存在，error.port 是不可用的网络连接端口。

error.syscall#

• 类型：<string>

error.syscall 属性是描述失败的 系统调用 的字符串。

常见系统错误#

这是在编写 Node.js 程序时常见系统错误的列表。有关完整列表，请参阅 errno(3) 手册页。

• EACCES（权限被拒绝）：尝试以文件访问权限禁止的方式访问文件。

• EADDRINUSE（地址已在使用中）：由于本地系统上的另一个服务器已占用该地址，导致绑定服务器（net、http 或 https）到本地地址的尝试失败。

• ECONNREFUSED（连接被拒绝）：无法建立连接，因为目标机器主动拒绝了它。这通常是因为尝试连接外部主机上未运行的服务。

• ECONNRESET（连接被对方重置）：连接被对等方强制关闭。这通常是因为远程套接字因超时或重启而导致连接丢失。通常通过 http 和 net 模块遇到。

• EEXIST（文件已存在）：现有的文件是操作的目标，但该操作要求目标不存在。

• EISDIR（是目录）：操作期望得到一个文件，但给定的路径名是一个目录。

• EMFILE（系统中打开的文件过多）：已达到系统允许的最大 文件描述符 数量，在至少关闭一个之前无法满足新的描述符请求。这通常在并行打开许多文件时遇到，特别是在进程文件描述符限制较低的系统（尤其是 macOS）上。要补救低限制，请在将运行 Node.js 进程的同一 shell 中运行 ulimit -n 2048。

• ENOENT（无此文件或目录）：通常由 fs 操作引发，表示指定路径名的某个组件不存在。在给定的路径下找不到任何实体（文件或目录）。

• ENOTDIR（不是目录）：给定路径名的某个组件存在，但不是预期的目录。通常由 fs.readdir 引发。

• ENOTEMPTY（目录不为空）：包含条目的目录是需要空目录的操作的目标，通常是 fs.unlink。

• ENOTFOUND（DNS 查找失败）：指示 EAI_NODATA 或 EAI_NONAME 的 DNS 失败。这不是标准的 POSIX 错误。

• EPERM（操作不允许）：尝试执行需要提升权限的操作。

• EPIPE（管道损坏）：对没有进程读取数据的管道、套接字或 FIFO 进行写入。通常在 net 和 http 层遇到，表明正在写入的流的远程端已被关闭。

• ETIMEDOUT（操作超时）：连接或发送请求失败，因为连接方在一段时间后没有正确响应。通常由 http 或 net 遇到。通常表明 socket.end() 未被正确调用。

类: TypeError#

• 继承 <errors.Error>

表示提供的参数不是允许的类型。例如，将函数传递给期望字符串的参数将是 TypeError。

require('node:url').parse(() => { });
// Throws TypeError, since it expected a string.
copy

Node.js 将作为参数验证的一种形式立即生成并抛出 TypeError 实例。

异常与错误#

JavaScript 异常是由于无效操作或作为 throw 语句的目标而抛出的值。虽然不要求这些值必须是 Error 或继承自 Error 的类的实例，但由 Node.js 或 JavaScript 运行时抛出的所有异常都将是 Error 的实例。

某些异常在 JavaScript 层是不可恢复的。此类异常将始终导致 Node.js 进程崩溃。示例包括 C++ 层中的 assert() 检查或 abort() 调用。

OpenSSL 错误#

源自 crypto 或 tls 的错误属于 Error 类，除了标准的 .code 和 .message 属性外，还可能具有一些额外的 OpenSSL 特有属性。

error.opensslErrorStack#

一组错误，可以提供关于错误源自 OpenSSL 库中何处的上下文。

error.function#

错误源自的 OpenSSL 函数。

error.library#

错误源自的 OpenSSL 库。

error.reason#

描述错误原因的人类可读字符串。

Node.js 错误代码#

ABORT_ERR#

用于操作已中止时（通常使用 AbortController）。

不使用 AbortSignal 的 API 通常不会引发带有此代码的错误。

此代码不使用 Node.js 错误中常规的 ERR_* 约定，以便与 Web 平台的 AbortError 兼容。

ERR_ACCESS_DENIED#

一种特殊类型的错误，每当 Node.js 尝试访问受 权限模型 限制的资源时，就会触发该错误。

ERR_AMBIGUOUS_ARGUMENT#

函数参数的使用方式暗示该函数签名可能被误解。当 assert.throws(block, message) 中的 message 参数与 block 抛出的错误消息匹配时，node:assert 模块会抛出此错误，因为这种用法表明用户认为 message 是预期的错误消息，而不是如果 block 未抛出时 AssertionError 将显示的消息。

ERR_ARG_NOT_ITERABLE#

需要一个可迭代参数（即适用于 for...of 循环的值），但 Node.js API 未提供。

ERR_ASSERTION#

一种特殊类型的错误，每当 Node.js 检测到不应发生的逻辑违规时可能会触发。这些错误通常由 node:assert 模块引发。

ERR_ASYNC_CALLBACK#

尝试将非函数的内容注册为 AsyncHooks 回调。

ERR_ASYNC_LOADER_REQUEST_NEVER_SETTLED#

与模块加载相关的操作由异步加载程序钩子自定义，但在加载程序线程退出之前，该钩子从未结算 Promise。

ERR_ASYNC_TYPE#

异步资源的类型无效。如果使用公共嵌入器 API，用户也可以定义自己的类型。

ERR_BROTLI_COMPRESSION_FAILED#

传递给 Brotli 流的数据未成功压缩。

ERR_BROTLI_INVALID_PARAM#

在构建 Brotli 流期间传递了无效的参数键。

ERR_BUFFER_CONTEXT_NOT_AVAILABLE#

尝试从插件或嵌入器代码创建 Node.js Buffer 实例，同时在与 Node.js 实例不关联的 JS 引擎上下文中。传递给 Buffer 方法的数据将在方法返回时被释放。

遇到此错误时，创建 Buffer 实例的一个可能替代方法是创建一个普通的 Uint8Array，它仅在结果对象的原型上有所不同。Uint8Array 通常在所有 Node.js 核心 API 中被接受（其中 Buffer 也被接受）；它们在所有上下文中都可用。

ERR_BUFFER_OUT_OF_BOUNDS#

尝试进行 Buffer 边界之外的操作。

ERR_BUFFER_TOO_LARGE#

尝试创建大于允许的最大尺寸的 Buffer。

ERR_CANNOT_WATCH_SIGINT#

Node.js 无法监视 SIGINT 信号。

ERR_CHILD_CLOSED_BEFORE_REPLY#

子进程在父进程收到回复之前已关闭。

ERR_CHILD_PROCESS_IPC_REQUIRED#

用于在未指定 IPC 通道的情况下 fork 子进程时。

ERR_CHILD_PROCESS_STDIO_MAXBUFFER#

用于主进程尝试从子进程的 STDERR/STDOUT 读取数据，且数据长度超过 maxBuffer 选项时。

ERR_CLOSED_MESSAGE_PORT#

尝试在关闭状态下使用 MessagePort 实例，通常在调用 .close() 之后。

ERR_CONSOLE_WRITABLE_STREAM#

实例化 Console 时没有 stdout 流，或者 Console 具有不可写的 stdout 或 stderr 流。

ERR_CONSTRUCT_CALL_INVALID#

调用了不可调用的类构造函数。

ERR_CONSTRUCT_CALL_REQUIRED#

在没有 new 的情况下调用了类的构造函数。

ERR_CONTEXT_NOT_INITIALIZED#

传入 API 的 vm 上下文尚未初始化。当在创建上下文期间发生错误（并被捕获）时可能会发生这种情况，例如当上下文创建时分配失败或达到最大调用堆栈大小时。

ERR_CPU_PROFILE_ALREADY_STARTED#

具有给定名称的 CPU 配置文件已启动。

ERR_CPU_PROFILE_NOT_STARTED#

具有给定名称的 CPU 配置文件未启动。

ERR_CPU_PROFILE_TOO_MANY#

正在收集的 CPU 配置文件过多。

ERR_CRYPTO_ARGON2_NOT_SUPPORTED#

所使用的当前版本的 OpenSSL 不支持 Argon2。

ERR_CRYPTO_CUSTOM_ENGINE_NOT_SUPPORTED#

请求了所使用的 OpenSSL 版本不支持的 OpenSSL 引擎（例如，通过 clientCertEngine 或 privateKeyEngine TLS 选项），这很可能是由于编译时标志 OPENSSL_NO_ENGINE 造成的。

ERR_CRYPTO_ECDH_INVALID_FORMAT#

传递给 crypto.ECDH() 类 getPublicKey() 方法的 format 参数的值无效。

ERR_CRYPTO_ECDH_INVALID_PUBLIC_KEY#

传递给 crypto.ECDH() 类 computeSecret() 方法的 key 参数的值无效。这意味着公钥位于椭圆曲线之外。

ERR_CRYPTO_ENGINE_UNKNOWN#

传递给了 require('node:crypto').setEngine() 无效的加密引擎标识符。

ERR_CRYPTO_FIPS_FORCED#

使用了 --force-fips 命令行参数，但在 node:crypto 模块中尝试启用或禁用 FIPS 模式。

ERR_CRYPTO_FIPS_UNAVAILABLE#

尝试启用或禁用 FIPS 模式，但 FIPS 模式不可用。

ERR_CRYPTO_HASH_FINALIZED#

多次调用了 hash.digest()。hash.digest() 方法对于每个 Hash 对象实例最多只能调用一次。

ERR_CRYPTO_HASH_UPDATE_FAILED#

hash.update() 因任何原因失败。这种情况极少发生。

ERR_CRYPTO_INCOMPATIBLE_KEY#

给定的加密密钥与尝试的操作不兼容。

ERR_CRYPTO_INCOMPATIBLE_KEY_OPTIONS#

选定的公钥或私钥编码与其他选项不兼容。

ERR_CRYPTO_INITIALIZATION_FAILED#

加密子系统的初始化失败。

ERR_CRYPTO_INVALID_AUTH_TAG#

提供了无效的身份验证标签。

ERR_CRYPTO_INVALID_COUNTER#

为计数器模式密码提供了无效的计数器。

ERR_CRYPTO_INVALID_CURVE#

提供了无效的椭圆曲线。

ERR_CRYPTO_INVALID_DIGEST#

指定了无效的 加密摘要算法。

ERR_CRYPTO_INVALID_IV#

提供了无效的初始化向量。

ERR_CRYPTO_INVALID_JWK#

提供了无效的 JSON Web Key。

ERR_CRYPTO_INVALID_KEYLEN#

提供了无效的密钥长度。

ERR_CRYPTO_INVALID_KEYPAIR#

提供了无效的密钥对。

ERR_CRYPTO_INVALID_KEYTYPE#

提供了无效的密钥类型。

ERR_CRYPTO_INVALID_KEY_OBJECT_TYPE#

给定的加密密钥对象类型对于尝试的操作无效。

ERR_CRYPTO_INVALID_MESSAGELEN#

提供了无效的消息长度。

ERR_CRYPTO_INVALID_SCRYPT_PARAMS#

一个或多个 crypto.scrypt() 或 crypto.scryptSync() 参数超出了其合法范围。

ERR_CRYPTO_INVALID_STATE#

在处于无效状态的对象上使用了加密方法。例如，在调用 cipher.final() 之前调用 cipher.getAuthTag()。

ERR_CRYPTO_INVALID_TAG_LENGTH#

提供了无效的身份验证标签长度。

ERR_CRYPTO_JOB_INIT_FAILED#

异步加密操作的初始化失败。

ERR_CRYPTO_JWK_UNSUPPORTED_CURVE#

密钥的椭圆曲线未在 JSON Web Key 椭圆曲线注册表 中注册以供使用。

ERR_CRYPTO_JWK_UNSUPPORTED_KEY_TYPE#

密钥的非对称密钥类型未在 JSON Web Key 类型注册表 中注册以供使用。

ERR_CRYPTO_KEM_NOT_SUPPORTED#

在 Node.js 未使用带有 KEM 支持的 OpenSSL 编译时，尝试使用 KEM 操作。

ERR_CRYPTO_OPERATION_FAILED#

加密操作因其他未指定的原因而失败。

ERR_CRYPTO_PBKDF2_ERROR#

PBKDF2 算法因未指定的原因而失败。OpenSSL 没有提供更多详细信息，因此 Node.js 也没有。

ERR_CRYPTO_SCRYPT_NOT_SUPPORTED#

Node.js 是在没有 scrypt 支持的情况下编译的。官方发布的二进制文件不可能出现这种情况，但在自定义构建（包括发行版构建）中可能会发生。

ERR_CRYPTO_SIGN_KEY_REQUIRED#

未向 sign.sign() 方法提供签名 key。

ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH#

crypto.timingSafeEqual() 被调用时，传入了不同长度的 Buffer、TypedArray 或 DataView 参数。

ERR_CRYPTO_UNKNOWN_CIPHER#

指定了未知的密码。

ERR_CRYPTO_UNKNOWN_DH_GROUP#

给出了未知的 Diffie-Hellman 组名称。有关有效组名称的列表，请参阅 crypto.getDiffieHellman()。

ERR_CRYPTO_UNSUPPORTED_OPERATION#

尝试调用不支持的加密操作。

ERR_DEBUGGER_ERROR#

调试器 发生错误。

ERR_DEBUGGER_STARTUP_ERROR#

调试器 在等待所需的 host/port 释放时超时。

ERR_DIR_CLOSED#

fs.Dir 此前已被关闭。

ERR_DIR_CONCURRENT_OPERATION#

尝试在具有正在进行的异步操作的 fs.Dir 上进行同步读取或关闭调用。

ERR_DLOPEN_DISABLED#

加载本机插件已被使用 --no-addons 禁用。

ERR_DLOPEN_FAILED#

对 process.dlopen() 的调用失败。

ERR_DNS_SET_SERVERS_FAILED#

c-ares 设置 DNS 服务器失败。

ERR_DOMAIN_CALLBACK_NOT_AVAILABLE#

node:domain 模块不可用，因为它无法建立所需的错误处理钩子，因为此前已在较早时间点调用了 process.setUncaughtExceptionCaptureCallback()。

ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE#

无法调用 process.setUncaughtExceptionCaptureCallback()，因为 node:domain 模块已在较早时间点被加载。

堆栈跟踪已扩展，包括加载 node:domain 模块的时间点。

ERR_DUPLICATE_STARTUP_SNAPSHOT_MAIN_FUNCTION#

无法调用 v8.startupSnapshot.setDeserializeMainFunction()，因为它之前已被调用过。

ERR_ENCODING_INVALID_ENCODED_DATA#

提供给 TextDecoder() API 的数据根据所提供的编码是无效的。

ERR_ENCODING_NOT_SUPPORTED#

提供给 TextDecoder() API 的编码不是 WHATWG 支持的编码 之一。

ERR_EVAL_ESM_CANNOT_PRINT#

--print 不能与 ESM 输入一起使用。

ERR_EVENT_RECURSION#

当尝试递归地在 EventTarget 上分发事件时抛出。

ERR_EXECUTION_ENVIRONMENT_NOT_AVAILABLE#

JS 执行上下文未与 Node.js 环境关联。当 Node.js 被用作嵌入式库且 JS 引擎的某些钩子未正确设置时，可能会发生这种情况。

ERR_FALSY_VALUE_REJECTION#

通过 util.callbackify() 回调化的 Promise 被一个虚假值拒绝。

ERR_FEATURE_UNAVAILABLE_ON_PLATFORM#

用于当运行 Node.js 的当前平台不可用的功能被使用时。

ERR_FS_CP_DIR_TO_NON_DIR#

尝试使用 fs.cp() 将目录复制到非目录（文件、符号链接等）。

ERR_FS_CP_EEXIST#

尝试使用 force 和 errorOnExist 设置为 true 的 fs.cp() 覆盖已存在的文件。

ERR_FS_CP_EINVAL#

使用 fs.cp() 时，src 或 dest 指向无效路径。

ERR_FS_CP_FIFO_PIPE#

尝试使用 fs.cp() 复制命名管道。

ERR_FS_CP_NON_DIR_TO_DIR#

尝试使用 fs.cp() 将非目录（文件、符号链接等）复制到目录。

ERR_FS_CP_SOCKET#

尝试使用 fs.cp() 复制到套接字。

ERR_FS_CP_SYMLINK_TO_SUBDIRECTORY#

使用 fs.cp() 时，dest 中的符号链接指向了 src 的子目录。

ERR_FS_CP_UNKNOWN#

尝试使用 fs.cp() 复制到未知文件类型。

ERR_FS_EISDIR#

路径是一个目录。

ERR_FS_FILE_TOO_LARGE#

尝试读取大于 fs.readFile() 所支持的 2 GiB 限制的文件。这不是 Buffer 的限制，而是内部 I/O 约束。对于处理更大的文件，请考虑使用 fs.createReadStream() 分块读取文件。

ERR_FS_WATCH_QUEUE_OVERFLOW#

排队但未处理的文件系统事件数量超过了 fs.watch() 中 maxQueue 指定的大小。

ERR_HTTP2_ALTSVC_INVALID_ORIGIN#

HTTP/2 ALTSVC 帧需要有效的来源。

ERR_HTTP2_ALTSVC_LENGTH#

HTTP/2 ALTSVC 帧限制为最多 16,382 字节的有效负载。

ERR_HTTP2_CONNECT_AUTHORITY#

对于使用 CONNECT 方法的 HTTP/2 请求，需要 :authority 伪标头。

ERR_HTTP2_CONNECT_PATH#

对于使用 CONNECT 方法的 HTTP/2 请求，禁止使用 :path 伪标头。

ERR_HTTP2_CONNECT_SCHEME#

对于使用 CONNECT 方法的 HTTP/2 请求，禁止使用 :scheme 伪标头。

ERR_HTTP2_ERROR#

发生了非特定的 HTTP/2 错误。

ERR_HTTP2_GOAWAY_SESSION#

在 Http2Session 接收到来自连接对端的 GOAWAY 帧后，可能无法打开新的 HTTP/2 流。

ERR_HTTP2_HEADERS_AFTER_RESPOND#

在启动 HTTP/2 响应后指定了额外的标头。

ERR_HTTP2_HEADERS_SENT#

尝试发送多个响应标头。

ERR_HTTP2_HEADER_SINGLE_VALUE#

为要求仅有一个值的 HTTP/2 标头字段提供了多个值。

ERR_HTTP2_INFO_STATUS_NOT_ALLOWED#

信息性 HTTP 状态码（1xx）不得在 HTTP/2 响应中设置为响应状态码。

ERR_HTTP2_INVALID_CONNECTION_HEADERS#

禁止在 HTTP/2 请求和响应中使用 HTTP/1 连接特定的标头。

ERR_HTTP2_INVALID_HEADER_VALUE#

指定了无效的 HTTP/2 标头值。

ERR_HTTP2_INVALID_INFO_STATUS#

指定了无效的 HTTP 信息性状态码。信息性状态码必须是 100 到 199（包含）之间的整数。

ERR_HTTP2_INVALID_ORIGIN#

HTTP/2 ORIGIN 帧需要有效的源（origin）。

ERR_HTTP2_INVALID_PACKED_SETTINGS_LENGTH#

传递给 http2.getUnpackedSettings() API 的输入 Buffer 和 Uint8Array 实例的长度必须是 6 的倍数。

ERR_HTTP2_INVALID_PSEUDOHEADER#

仅可使用有效的 HTTP/2 伪标头（:status、:path、:authority、:scheme 和 :method）。

ERR_HTTP2_INVALID_SESSION#

对已经销毁的 Http2Session 对象执行了操作。

ERR_HTTP2_INVALID_SETTING_VALUE#

为 HTTP/2 设置指定了无效的值。

ERR_HTTP2_INVALID_STREAM#

对已经销毁的流执行了操作。

ERR_HTTP2_MAX_PENDING_SETTINGS_ACK#

每当向连接的对端发送 HTTP/2 SETTINGS 帧时，对端都需要发送确认，表明其已接收并应用了新的 SETTINGS。默认情况下，在任何给定时间内可能发送未确认的 SETTINGS 帧的最大数量是有限的。当达到该限制时会使用此错误代码。

ERR_HTTP2_NESTED_PUSH#

尝试从推送流内发起新的推送流。不允许嵌套推送流。

ERR_HTTP2_NO_MEM#

在使用 http2session.setLocalWindowSize(windowSize) API 时内存不足。

ERR_HTTP2_NO_SOCKET_MANIPULATION#

尝试直接操作（读取、写入、暂停、恢复等）附加到 Http2Session 的套接字。

ERR_HTTP2_ORIGIN_LENGTH#

HTTP/2 ORIGIN 帧的长度限制为 16382 字节。

ERR_HTTP2_OUT_OF_STREAMS#

在单个 HTTP/2 会话上创建的流数量达到了最大限制。

ERR_HTTP2_PAYLOAD_FORBIDDEN#

为禁止承载有效载荷的 HTTP 响应代码指定了消息有效载荷。

ERR_HTTP2_PING_CANCEL#

HTTP/2 ping 已取消。

ERR_HTTP2_PING_LENGTH#

HTTP/2 ping 有效载荷的长度必须恰好为 8 字节。

ERR_HTTP2_PSEUDOHEADER_NOT_ALLOWED#

HTTP/2 伪标头使用不当。伪标头是以 : 前缀开头的标头键名。

ERR_HTTP2_PUSH_DISABLED#

尝试创建已被客户端禁用的推送流。

ERR_HTTP2_SEND_FILE#

尝试使用 Http2Stream.prototype.responseWithFile() API 发送目录。

ERR_HTTP2_SEND_FILE_NOSEEK#

尝试使用 Http2Stream.prototype.responseWithFile() API 发送非普通文件，但提供了 offset 或 length 选项。

ERR_HTTP2_SESSION_ERROR#

Http2Session 以非零错误代码关闭。

ERR_HTTP2_SETTINGS_CANCEL#

Http2Session 设置已取消。

ERR_HTTP2_SOCKET_BOUND#

尝试将 Http2Session 对象连接到已绑定到另一个 Http2Session 对象的 net.Socket 或 tls.TLSSocket。

ERR_HTTP2_SOCKET_UNBOUND#

尝试使用已关闭的 Http2Session 的 socket 属性。

ERR_HTTP2_STATUS_101#

禁止在 HTTP/2 中使用 101 信息性状态码。

ERR_HTTP2_STATUS_INVALID#

指定了无效的 HTTP 状态码。状态码必须是 100 到 599（包含）之间的整数。

ERR_HTTP2_STREAM_CANCEL#

Http2Stream 在向连接对端传输任何数据之前被销毁。

ERR_HTTP2_STREAM_ERROR#

在 RST_STREAM 帧中指定了非零错误代码。

ERR_HTTP2_STREAM_SELF_DEPENDENCY#

在设置 HTTP/2 流的优先级时，流可以被标记为父流的依赖项。当尝试将流标记为自身依赖项时，会使用此错误代码。

ERR_HTTP2_TOO_MANY_CUSTOM_SETTINGS#

已超过支持的自定义设置数量（10）。

ERR_HTTP2_TOO_MANY_INVALID_FRAMES#

已超过通过 maxSessionInvalidFrames 选项指定的对端发送的可接受无效 HTTP/2 协议帧的限制。

ERR_HTTP2_TRAILERS_ALREADY_SENT#

已在 Http2Stream 上发送了尾部标头。

ERR_HTTP2_TRAILERS_NOT_READY#

在 Http2Stream 对象上发出 'wantTrailers' 事件之前，无法调用 http2stream.sendTrailers() 方法。仅当为 Http2Stream 设置了 waitForTrailers 选项时，才会发出 'wantTrailers' 事件。

ERR_HTTP2_UNSUPPORTED_PROTOCOL#

http2.connect() 被传入了除 http: 或 https: 之外的任何协议的 URL。

ERR_HTTP_BODY_NOT_ALLOWED#

在写入不允许内容的 HTTP 响应时抛出错误。

ERR_HTTP_CONTENT_LENGTH_MISMATCH#

响应体大小与指定的 content-length 标头值不匹配。

ERR_HTTP_HEADERS_SENT#

尝试在标头已发送后添加更多标头。

ERR_HTTP_INVALID_HEADER_VALUE#

指定了无效的 HTTP 标头值。

ERR_HTTP_INVALID_STATUS_CODE#

状态码超出了常规状态码范围（100-999）。

ERR_HTTP_REQUEST_TIMEOUT#

客户端未在允许的时间内发送完整请求。

ERR_HTTP_SOCKET_ASSIGNED#

给定的 ServerResponse 已分配了套接字。

ERR_HTTP_SOCKET_ENCODING#

根据 RFC 7230 第 3 节，不允许更改套接字编码。

ERR_HTTP_TRAILER_INVALID#

即使传输编码不支持，也设置了 Trailer 标头。

ERR_ILLEGAL_CONSTRUCTOR#

尝试使用非公开构造函数构造对象。

ERR_IMPORT_ATTRIBUTE_MISSING#

缺少导入属性，导致无法导入指定的模块。

ERR_IMPORT_ATTRIBUTE_TYPE_INCOMPATIBLE#

提供了导入 type 属性，但指定的模块是不同类型的。

ERR_IMPORT_ATTRIBUTE_UNSUPPORTED#

当前版本的 Node.js 不支持导入属性。

ERR_INCOMPATIBLE_OPTION_PAIR#

选项对彼此不兼容，不能同时使用。

ERR_INPUT_TYPE_NOT_ALLOWED#

使用 --input-type 标志尝试执行文件。此标志只能与通过 --eval、--print 或 STDIN 的输入一起使用。

ERR_INSPECTOR_ALREADY_ACTIVATED#

在使用 node:inspector 模块时，尝试在调试器已开始监听端口时激活它。在不同地址激活之前请使用 inspector.close()。

ERR_INSPECTOR_ALREADY_CONNECTED#

在使用 node:inspector 模块时，尝试在调试器已连接时进行连接。

ERR_INSPECTOR_CLOSED#

在使用 node:inspector 模块时，尝试在会话已关闭后使用调试器。

ERR_INSPECTOR_COMMAND#

通过 node:inspector 模块发出命令时发生错误。

ERR_INSPECTOR_NOT_ACTIVE#

调用 inspector.waitForDebugger() 时，inspector 未激活。

ERR_INSPECTOR_NOT_AVAILABLE#

node:inspector 模块不可用。

ERR_INSPECTOR_NOT_CONNECTED#

在使用 node:inspector 模块时，尝试在连接之前使用调试器。

ERR_INSPECTOR_NOT_WORKER#

在主线程上调用了只能在工作线程中使用的 API。

ERR_INTERNAL_ASSERTION#

Node.js 内部存在错误或对 Node.js 内部的使用不正确。要修复此错误，请在 https://github.com/nodejs/node/issues 开一个 issue。

ERR_INVALID_ADDRESS#

Node.js API 无法识别提供的地址。

ERR_INVALID_ADDRESS_FAMILY#

Node.js API 无法识别提供的地址族。

ERR_INVALID_ARG_TYPE#

向 Node.js API 传递了错误类型的参数。

ERR_INVALID_ARG_VALUE#

为给定参数传递了无效或不受支持的值。

ERR_INVALID_ASYNC_ID#

使用 AsyncHooks 传递了无效的 asyncId 或 triggerAsyncId。不应出现小于 -1 的 id。

ERR_INVALID_BUFFER_SIZE#

在 Buffer 上执行了交换操作，但其大小与该操作不兼容。

ERR_INVALID_CHAR#

在标头中检测到无效字符。

ERR_INVALID_CURSOR_POS#

如果没有指定列，则无法将给定流上的光标移动到指定行。

ERR_INVALID_FD#

文件描述符 ('fd') 无效（例如，它是负值）。

ERR_INVALID_FD_TYPE#

文件描述符 ('fd') 类型无效。

ERR_INVALID_FILE_URL_HOST#

消耗 file: URL 的 Node.js API（例如 fs 模块中的某些函数）遇到了具有不兼容主机的 URL。这种情况仅在支持 localhost 或空主机的类 Unix 系统上才会发生。

ERR_INVALID_FILE_URL_PATH#

消耗 file: URL 的 Node.js API（例如 fs 模块中的某些函数）遇到了具有不兼容路径的 URL。确定路径是否可用的确切语义与平台相关。

抛出的错误对象包含一个 input 属性，其中包含无效 file: URL 的 URL 对象。

ERR_INVALID_HANDLE_TYPE#

尝试通过 IPC 通信通道向子进程发送不受支持的“句柄”。有关更多信息，请参阅 subprocess.send() 和 process.send()。

ERR_INVALID_HTTP_TOKEN#

提供了无效的 HTTP 令牌。

ERR_INVALID_IP_ADDRESS#

IP 地址无效。

ERR_INVALID_MIME_SYNTAX#

MIME 的语法无效。

ERR_INVALID_MODULE#

尝试加载不存在或无效的模块。

ERR_INVALID_MODULE_SPECIFIER#

导入的模块字符串是无效的 URL、包名称或包子路径说明符。

ERR_INVALID_OBJECT_DEFINE_PROPERTY#

在设置对象属性的无效属性时发生错误。

ERR_INVALID_PACKAGE_CONFIG#

无效的 package.json 文件解析失败。

ERR_INVALID_PACKAGE_TARGET#

package.json "exports" 字段包含对于尝试的模块解析无效的目标映射值。

ERR_INVALID_PROTOCOL#

向 http.request() 传递了无效的 options.protocol。

ERR_INVALID_REPL_EVAL_CONFIG#

在 REPL 配置中同时设置了 breakEvalOnSigint 和 eval 选项，这是不支持的。

ERR_INVALID_REPL_INPUT#

输入可能无法在 REPL 中使用。使用此错误的条件在 REPL 文档中有描述。

ERR_INVALID_RETURN_PROPERTY#

在函数选项在执行时未为其返回的对象属性提供有效值时抛出。

ERR_INVALID_RETURN_PROPERTY_VALUE#

在函数选项在执行时未为其返回的对象属性提供预期的值类型时抛出。

ERR_INVALID_RETURN_VALUE#

在函数选项在执行时未返回预期的值类型时抛出（例如，当预期函数返回 Promise 时）。

ERR_INVALID_STATE#

表明由于状态无效，操作无法完成。例如，对象可能已被销毁，或者正在执行另一个操作。

ERR_INVALID_SYNC_FORK_INPUT#

将 Buffer、TypedArray、DataView 或 string 作为 stdio 输入提供给了异步 fork。有关更多信息，请参阅 child_process 模块的文档。

ERR_INVALID_THIS#

Node.js API 函数以不兼容的 this 值调用。

const urlSearchParams = new URLSearchParams('foo=bar&baz=new');

const buf = Buffer.alloc(1);
urlSearchParams.has.call(buf, 'foo');
// Throws a TypeError with code 'ERR_INVALID_THIS'
copy

ERR_INVALID_TUPLE#

提供给 WHATWG URLSearchParams 构造函数 的 iterable 中的元素不代表 [name, value] 元组——也就是说，如果元素不可迭代，或者不恰好由两个元素组成。

ERR_INVALID_TYPESCRIPT_SYNTAX#

提供的 TypeScript 语法无效。

ERR_INVALID_URI#

传递了无效的 URI。

ERR_INVALID_URL#

向 WHATWG URL 构造函数 或旧版 url.parse() 传递了无效的 URL 以进行解析。抛出的错误对象通常具有一个额外的属性 'input'，其中包含解析失败的 URL。

ERR_INVALID_URL_PATTERN#

向 WHATWG URLPattern 构造函数 传递了无效的 URLPattern 以进行解析。

ERR_INVALID_URL_SCHEME#

尝试为特定目的使用具有不兼容方案（协议）的 URL。它仅在 fs 模块中的 WHATWG URL API 支持中使用（该模块仅接受带有 'file' 方案的 URL），但在未来也可能在其他 Node.js API 中使用。

ERR_IPC_CHANNEL_CLOSED#

尝试使用已关闭的 IPC 通信通道。

ERR_IPC_DISCONNECTED#

尝试断开已断开连接的 IPC 通信通道。有关更多信息，请参阅 child_process 模块的文档。

ERR_IPC_ONE_PIPE#

尝试使用多个 IPC 通信通道创建子 Node.js 进程。有关更多信息，请参阅 child_process 模块的文档。

ERR_IPC_SYNC_FORK#

尝试与同步 fork 的 Node.js 进程打开 IPC 通信通道。有关更多信息，请参阅 child_process 模块的文档。

ERR_IP_BLOCKED#

IP 被 net.BlockList 阻止。

ERR_LOADER_CHAIN_INCOMPLETE#

ESM 加载器钩子在未调用 next() 且未显式发出短路信号的情况下返回。

ERR_LOAD_SQLITE_EXTENSION#

加载 SQLite 扩展时发生错误。

ERR_MEMORY_ALLOCATION_FAILED#

尝试分配内存（通常在 C++ 层）但失败了。

ERR_MESSAGE_TARGET_CONTEXT_UNAVAILABLE#

发布到 MessagePort 的消息无法在目标 vm Context 中反序列化。目前并非所有 Node.js 对象都能在任何上下文中成功实例化，在这种情况下，尝试使用 postMessage() 传输它们可能会在接收端失败。

ERR_METHOD_NOT_IMPLEMENTED#

需要方法但未实现。

ERR_MISSING_ARGS#

未传递 Node.js API 的必需参数。这仅用于严格遵守 API 规范（在某些情况下，该规范可能接受 func(undefined) 但不接受 func()）。在大多数原生 Node.js API 中，func(undefined) 和 func() 被视为相同，因此可以使用 ERR_INVALID_ARG_TYPE 错误代码代替。

ERR_MISSING_OPTION#

对于接受选项对象的 API，某些选项可能是强制性的。如果缺少必需的选项，则抛出此代码。

ERR_MISSING_PASSPHRASE#

尝试在未指定密码短语的情况下读取加密密钥。

ERR_MISSING_PLATFORM_FOR_WORKER#

此 Node.js 实例使用的 V8 平台不支持创建 Worker。这是由于嵌入器缺乏对 Worker 的支持。特别是，标准构建的 Node.js 不会发生此错误。

ERR_MODULE_LINK_MISMATCH#

模块无法链接，因为其中的相同模块请求没有解析到同一个模块。

ERR_MODULE_NOT_FOUND#

ECMAScript 模块加载器在尝试 import 操作或加载程序入口点时，无法解析模块文件。

ERR_MULTIPLE_CALLBACK#

回调函数被调用了不止一次。

回调函数几乎总是只打算被调用一次，因为查询既可以被满足也可以被拒绝，但不能同时两者兼得。通过多次调用回调函数可能会实现后者。

ERR_NAPI_CONS_FUNCTION#

在使用 Node-API 时，传入的构造函数不是函数。

ERR_NAPI_INVALID_DATAVIEW_ARGS#

在调用 napi_create_dataview() 时，给定的 offset 超出了 dataview 的边界，或者 offset + length 大于给定 buffer 的长度。

ERR_NAPI_INVALID_TYPEDARRAY_ALIGNMENT#

在调用 napi_create_typedarray() 时，提供的 offset 不是元素大小的倍数。

ERR_NAPI_INVALID_TYPEDARRAY_LENGTH#

在调用 napi_create_typedarray() 时，(length * size_of_element) + byte_offset 大于给定 buffer 的长度。

ERR_NAPI_TSFN_CALL_JS#

在调用线程安全函数的 JavaScript 部分时发生错误。

ERR_NAPI_TSFN_GET_UNDEFINED#

在尝试检索 JavaScript undefined 值时发生错误。

ERR_NON_CONTEXT_AWARE_DISABLED#

在禁止非上下文感知的原生插件的进程中加载了非上下文感知的插件。

ERR_NOT_BUILDING_SNAPSHOT#

尝试使用仅在构建 V8 启动快照时才能使用的操作，尽管 Node.js 并没有在构建。

ERR_NOT_IN_SINGLE_EXECUTABLE_APPLICATION#

当不在单个可执行应用程序中时，无法执行该操作。

ERR_NOT_SUPPORTED_IN_SNAPSHOT#

尝试执行在构建启动快照时不支持的操作。

ERR_NO_CRYPTO#

尝试在 Node.js 未使用 OpenSSL 加密支持编译的情况下使用加密功能。

ERR_NO_ICU#

尝试使用需要 ICU 的功能，但 Node.js 未使用 ICU 支持编译。

ERR_NO_TYPESCRIPT#

尝试使用需要 原生 TypeScript 支持 的功能，但 Node.js 未使用 TypeScript 支持编译。

ERR_OPERATION_FAILED#

操作失败。这通常用于表示异步操作的总体失败。

ERR_OPTIONS_BEFORE_BOOTSTRAPPING#

在引导完成之前尝试获取选项。

ERR_OUT_OF_RANGE#

给定值超出了接受范围。

ERR_PACKAGE_IMPORT_NOT_DEFINED#

package.json "imports" 字段未定义给定的内部包说明符映射。

ERR_PACKAGE_PATH_NOT_EXPORTED#

package.json "exports" 字段未导出请求的子路径。由于导出是封装的，因此除非使用绝对 URL，否则无法通过包解析导入未导出的私有内部模块。

ERR_PARSE_ARGS_INVALID_OPTION_VALUE#

当 strict 设置为 true 时，如果为类型为 <string> 的选项提供了 <boolean> 值，或者如果为类型为 <boolean> 的选项提供了 <string> 值，则由 util.parseArgs() 抛出。

ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL#

当提供了位置参数且 allowPositionals 设置为 false 时，由 util.parseArgs() 抛出。

ERR_PARSE_ARGS_UNKNOWN_OPTION#

当 strict 设置为 true 时，如果参数未在 options 中配置，则由 util.parseArgs() 抛出。

ERR_PERFORMANCE_INVALID_TIMESTAMP#

为性能标记或度量提供了无效的时间戳值。

ERR_PERFORMANCE_MEASURE_INVALID_OPTIONS#

为性能度量提供了无效选项。

ERR_PROTO_ACCESS#

使用 --disable-proto=throw 禁止访问 Object.prototype.__proto__。应使用 Object.getPrototypeOf 和 Object.setPrototypeOf 来获取和设置对象的原型。

ERR_PROXY_INVALID_CONFIG#

由于代理配置无效，代理请求失败。

ERR_PROXY_TUNNEL#

当启用了 NODE_USE_ENV_PROXY 或 --use-env-proxy 时，建立代理隧道失败。

ERR_QUIC_APPLICATION_ERROR#

发生了 QUIC 应用程序错误。

ERR_QUIC_CONNECTION_FAILED#

建立 QUIC 连接失败。

ERR_QUIC_ENDPOINT_CLOSED#

QUIC 端点因错误关闭。

ERR_QUIC_OPEN_STREAM_FAILED#

打开 QUIC 流失败。

ERR_QUIC_TRANSPORT_ERROR#

发生了 QUIC 传输错误。

ERR_QUIC_VERSION_NEGOTIATION_ERROR#

由于需要版本协商，QUIC 会话失败。

ERR_REQUIRE_ASYNC_MODULE#

当尝试 require() 一个 ES 模块时，该模块被证明是异步的。也就是说，它包含顶级 await。

要查看顶级 await 的位置，请使用 --experimental-print-required-tla（这将在查找顶级 await 之前执行模块）。

ERR_REQUIRE_CYCLE_MODULE#

当尝试 require() 一个 ES 模块时，CommonJS 到 ESM 或 ESM 到 CommonJS 的边界参与了一个即时循环。这是不允许的，因为 ES 模块在被求值时不能被重新求值。

为了避免循环，参与循环的 require() 调用不应在 ES 模块（通过 createRequire()）或 CommonJS 模块的顶级发生，而应在内部函数中惰性执行。

ERR_REQUIRE_ESM#

尝试 require() 一个 ES 模块。

此错误已被弃用，因为 require() 现在支持加载同步 ES 模块。当 require() 遇到包含顶级 await 的 ES 模块时，它将抛出 ERR_REQUIRE_ASYNC_MODULE 代替。

ERR_SCRIPT_EXECUTION_INTERRUPTED#

脚本执行被 SIGINT 中断（例如，按下了 Ctrl+C）。

ERR_SCRIPT_EXECUTION_TIMEOUT#

脚本执行超时，可能是由于正在执行的脚本中存在错误。

ERR_SERVER_ALREADY_LISTEN#

在 net.Server 已经在监听时调用了 server.listen() 方法。这适用于 net.Server 的所有实例，包括 HTTP、HTTPS 和 HTTP/2 Server 实例。

ERR_SERVER_NOT_RUNNING#

在 net.Server 未运行时调用了 server.close() 方法。这适用于 net.Server 的所有实例，包括 HTTP、HTTPS 和 HTTP/2 Server 实例。

ERR_SINGLE_EXECUTABLE_APPLICATION_ASSET_NOT_FOUND#

向单个可执行应用程序 API 传递了键以标识资产，但未找到匹配项。

ERR_SOCKET_ALREADY_BOUND#

尝试绑定已绑定的套接字。

ERR_SOCKET_BAD_BUFFER_SIZE#

为 dgram.createSocket() 中的 recvBufferSize 或 sendBufferSize 选项传递了无效（负）大小。

ERR_SOCKET_BAD_PORT#

期望端口 >= 0 且 < 65536 的 API 函数收到了无效值。

ERR_SOCKET_BAD_TYPE#

期望套接字类型（udp4 或 udp6）的 API 函数收到了无效值。

ERR_SOCKET_BUFFER_SIZE#

在使用 dgram.createSocket() 时，无法确定接收或发送 Buffer 的大小。

ERR_SOCKET_CLOSED#

尝试对已关闭的套接字进行操作。

ERR_SOCKET_CLOSED_BEFORE_CONNECTION#

在连接中的套接字上调用 net.Socket.write() 且套接字在建立连接之前关闭时。

ERR_SOCKET_CONNECTION_TIMEOUT#

在使用地址族自动选择算法时，套接字无法在允许的超时时间内连接到 DNS 返回的任何地址。

ERR_SOCKET_DGRAM_IS_CONNECTED#

在已连接的套接字上进行了 dgram.connect() 调用。

ERR_SOCKET_DGRAM_NOT_CONNECTED#

在未连接的套接字上进行了 dgram.disconnect() 或 dgram.remoteAddress() 调用。

ERR_SOCKET_DGRAM_NOT_RUNNING#

进行了调用但 UDP 子系统未运行。

ERR_SOURCE_MAP_CORRUPT#

源映射无法解析，因为它不存在或已损坏。

ERR_SOURCE_MAP_MISSING_SOURCE#

未找到从源映射导入的文件。

ERR_SOURCE_PHASE_NOT_DEFINED#

提供的模块导入没有为源阶段导入语法 import source x from 'x' 或 import.source(x) 提供源阶段导入表示。

ERR_SQLITE_ERROR#

从 SQLite 返回了错误。

ERR_SRI_PARSE#

提供了用于子资源完整性检查的字符串，但无法解析。通过查看 子资源完整性规范 来检查完整性属性的格式。

ERR_STREAM_ALREADY_FINISHED#

调用了无法完成的流方法，因为流已完成。

ERR_STREAM_CANNOT_PIPE#

尝试在 Writable 流上调用 stream.pipe()。

ERR_STREAM_DESTROYED#

调用了无法完成的流方法，因为使用 stream.destroy() 销毁了流。

ERR_STREAM_NULL_VALUES#

尝试使用 null 数据块调用 stream.write()。

ERR_STREAM_PREMATURE_CLOSE#

当流或管道非优雅地结束且没有明确错误时，由 stream.finished() 和 stream.pipeline() 返回的错误。

ERR_STREAM_PUSH_AFTER_EOF#

在向流推送了 null(EOF) 后，尝试调用 stream.push()。

ERR_STREAM_UNABLE_TO_PIPE#

在管道中尝试管道传输到已关闭或销毁的流。

ERR_STREAM_UNSHIFT_AFTER_END_EVENT#

在发出 'end' 事件后，尝试调用 stream.unshift()。

ERR_STREAM_WRAP#

防止如果套接字上设置了字符串解码器或解码器处于 objectMode 时出现中止。

const Socket = require('node:net').Socket;
const instance = new Socket();

instance.setEncoding('utf8');
copy

ERR_STREAM_WRITE_AFTER_END#

在调用 stream.end() 后，尝试调用 stream.write()。

ERR_STRING_TOO_LONG#

尝试创建长度超过最大允许长度的字符串。

ERR_SYNTHETIC#

用于捕获诊断报告调用堆栈的人工错误对象。

ERR_SYSTEM_ERROR#

Node.js 进程内发生了未指定的或非特定的系统错误。错误对象将具有一个 err.info 对象属性，其中包含详细信息。

ERR_TEST_FAILURE#

此错误表示测试失败。有关失败的其他信息可通过 cause 属性获得。failureType 属性指定了失败发生时测试正在执行的操作。

ERR_TLS_ALPN_CALLBACK_INVALID_RESULT#

当 ALPNCallback 返回的值不在客户端提供的 ALPN 协议列表中时，会抛出此错误。

ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS#

如果在 TLS 选项中同时包含 ALPNProtocols 和 ALPNCallback，则在创建 TLSServer 时会抛出此错误。这些选项是互斥的。

ERR_TLS_CERT_ALTNAME_FORMAT#

如果用户提供的 subjectaltname 属性违反编码规则，则 checkServerIdentity 会抛出此错误。Node.js 本身生成的证书对象始终符合编码规则，永远不会导致此错误。

ERR_TLS_CERT_ALTNAME_INVALID#

在使用 TLS 时，对端的 host 名称/IP 与其证书中的任何 subjectAltNames 都不匹配。

ERR_TLS_DH_PARAM_SIZE#

在使用 TLS 时，为 Diffie-Hellman (DH) 密钥协商协议提供的参数太小。默认情况下，密钥长度必须大于或等于 1024 位才能避免漏洞，尽管强烈建议为了更强的安全性使用 2048 位或更大。

ERR_TLS_HANDSHAKE_TIMEOUT#

TLS/SSL 握手超时。在这种情况下，服务器也必须中止连接。

ERR_TLS_INVALID_CONTEXT#

上下文必须是 SecureContext。

ERR_TLS_INVALID_PROTOCOL_METHOD#

指定的 secureProtocol 方法无效。它要么未知，要么因不安全而被禁用。

ERR_TLS_INVALID_PROTOCOL_VERSION#

有效的 TLS 协议版本为 'TLSv1'、'TLSv1.1' 或 'TLSv1.2'。

ERR_TLS_INVALID_STATE#

TLS 套接字必须已连接并安全建立。在继续之前，请确保发出 'secure' 事件。

ERR_TLS_PROTOCOL_VERSION_CONFLICT#

尝试设置 TLS 协议 minVersion 或 maxVersion 与尝试显式设置 secureProtocol 冲突。请使用其中一种机制。

ERR_TLS_PSK_SET_IDENTITY_HINT_FAILED#

设置 PSK 身份提示失败。提示可能太长。

ERR_TLS_RENEGOTIATION_DISABLED#

尝试在禁用了重新协商的套接字实例上重新协商 TLS。

ERR_TLS_REQUIRED_SERVER_NAME#

在使用 TLS 时，在未在第一个参数中提供主机名的情况下调用了 server.addContext() 方法。

ERR_TLS_SESSION_ATTACK#

检测到过多的 TLS 重新协商，这是拒绝服务攻击的潜在向量。

ERR_TLS_SNI_FROM_SERVER#

尝试从 TLS 服务器端套接字发出服务器名称指示（SNI），该指示仅对客户端有效。

ERR_TRACE_EVENTS_CATEGORY_REQUIRED#

trace_events.createTracing() 方法至少需要一个跟踪事件类别。

ERR_TRACE_EVENTS_UNAVAILABLE#

无法加载 node:trace_events 模块，因为 Node.js 是使用 --without-v8-platform 标志编译的。

ERR_TRAILING_JUNK_AFTER_STREAM_END#

在压缩流末尾发现尾部垃圾数据。当在压缩流末尾检测到额外的意外数据时（例如，在 zlib 或 gzip 解压缩中），会抛出此错误。

ERR_TRANSFORM_ALREADY_TRANSFORMING#

Transform 流在仍在转换时完成。

ERR_TRANSFORM_WITH_LENGTH_0#

Transform 流在写缓冲区中仍有数据的情况下完成。

ERR_TTY_INIT_FAILED#

由于系统错误，TTY 初始化失败。

ERR_UNAVAILABLE_DURING_EXIT#

在 process.on('exit') 处理程序内调用了不应在 process.on('exit') 处理程序内调用的函数。

ERR_UNCAUGHT_EXCEPTION_CAPTURE_ALREADY_SET#

在未先将回调重置为 null 的情况下，两次调用了 process.setUncaughtExceptionCaptureCallback()。

此错误旨在防止意外覆盖从另一个模块注册的回调。

ERR_UNESCAPED_CHARACTERS#

收到了包含未转义字符的字符串。

ERR_UNHANDLED_ERROR#

发生了未处理的错误（例如，当 EventEmitter 发出 'error' 事件但未注册 'error' 处理程序时）。

ERR_UNKNOWN_BUILTIN_MODULE#

用于标识不应由用户代码触发的特定类型的内部 Node.js 错误。此错误的实例指向 Node.js 二进制文件本身的内部错误。

ERR_UNKNOWN_CREDENTIAL#

传递了不存在的 Unix 组或用户标识符。

ERR_UNKNOWN_ENCODING#

向 API 传递了无效或未知的编码选项。

ERR_UNKNOWN_FILE_EXTENSION#

尝试加载具有未知或不受支持文件扩展名的模块。

ERR_UNKNOWN_MODULE_FORMAT#

尝试加载具有未知或不受支持格式的模块。

ERR_UNKNOWN_SIGNAL#

向期望有效信号的 API（例如 subprocess.kill()）传递了无效或未知的进程信号。

ERR_UNSUPPORTED_DIR_IMPORT#

不支持 import 目录 URL。相反，请使用其名称引用包，并在 package.json 文件的 "exports" 字段中定义自定义子路径。

import './'; // unsupported
import './index.js'; // supported
import 'package-name'; // supported
copy

ERR_UNSUPPORTED_ESM_URL_SCHEME#

不支持使用除 file 和 data 之外的 URL 方案的 import。

ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING#

node_modules 目录下的后代文件不支持类型剥离（type stripping）。

ERR_UNSUPPORTED_RESOLVE_REQUEST#

尝试解析无效的模块引用者。当导入或调用 import.meta.resolve() 并包含以下情况时，可能会发生这种情况：

• 来自 URL 方案不是 file 的模块，且不是内置模块的裸说明符。
• 来自 URL 方案不是 特殊方案 的模块的 相对 URL。

try {
  // Trying to import the package 'bare-specifier' from a `data:` URL module:
  await import('data:text/javascript,import "bare-specifier"');
} catch (e) {
  console.log(e.code); // ERR_UNSUPPORTED_RESOLVE_REQUEST
}
copy

ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX#

提供的 TypeScript 语法不受支持。这在使用需要使用 类型剥离 进行转换的 TypeScript 语法时可能会发生。

ERR_USE_AFTER_CLOSE#

尝试使用已关闭的事物。

ERR_VALID_PERFORMANCE_ENTRY_TYPE#

在使用性能计时 API (perf_hooks) 时，未找到有效的性能条目类型。

ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING#

未指定动态导入回调。

ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING_FLAG#

在没有 --experimental-vm-modules 的情况下调用了动态导入回调。

ERR_VM_MODULE_ALREADY_LINKED#

尝试链接的模块由于以下原因之一而不符合链接条件：

• 它已经被链接 (linkingStatus 为 'linked')
• 它正在被链接 (linkingStatus 为 'linking')
• 此模块链接失败 (linkingStatus 为 'errored')

ERR_VM_MODULE_CACHED_DATA_REJECTED#

传递给模块构造函数的 cachedData 选项无效。

ERR_VM_MODULE_CANNOT_CREATE_CACHED_DATA#

无法为已经求值的模块创建缓存数据。

ERR_VM_MODULE_DIFFERENT_CONTEXT#

从链接器函数返回的模块与父模块来自不同的上下文。链接的模块必须共享相同的上下文。

ERR_VM_MODULE_LINK_FAILURE#

由于失败，模块无法链接。

ERR_VM_MODULE_NOT_MODULE#

链接承诺的履行值不是 vm.Module 对象。

ERR_VM_MODULE_STATUS#

当前模块的状态不允许此操作。该错误的具体含义取决于具体函数。

ERR_WASI_ALREADY_STARTED#

WASI 实例已经启动。

ERR_WASI_NOT_STARTED#

WASI 实例尚未启动。

ERR_WEBASSEMBLY_NOT_SUPPORTED#

使用了需要 WebAssembly 的功能，但在当前环境中 WebAssembly 不受支持或已被禁用（例如，使用 --jitless 运行时）。

ERR_WEBASSEMBLY_RESPONSE#

已传递给 WebAssembly.compileStreaming 或 WebAssembly.instantiateStreaming 的 Response 不是有效的 WebAssembly 响应。

ERR_WORKER_INIT_FAILED#

Worker 初始化失败。

ERR_WORKER_INVALID_EXEC_ARGV#

传递给 Worker 构造函数的 execArgv 选项包含无效标志。

ERR_WORKER_MESSAGING_ERRORED#

目标线程在处理通过 postMessageToThread() 发送的消息时抛出了错误。

ERR_WORKER_MESSAGING_FAILED#

postMessageToThread() 中请求的线程无效或没有 workerMessage 监听器。

ERR_WORKER_MESSAGING_SAME_THREAD#

postMessageToThread() 中请求的线程 id 是当前线程 id。

ERR_WORKER_MESSAGING_TIMEOUT#

通过 postMessageToThread() 发送消息超时。

ERR_WORKER_NOT_RUNNING#

操作失败，因为 Worker 实例当前未运行。

ERR_WORKER_OUT_OF_MEMORY#

Worker 实例因达到其内存限制而终止。

ERR_WORKER_PATH#

Worker 主脚本的路径既不是绝对路径，也不是以 ./ 或 ../ 开头的相对路径。

ERR_WORKER_UNSERIALIZABLE_ERROR#

序列化来自工作线程的未捕获异常的所有尝试均失败。

ERR_WORKER_UNSUPPORTED_OPERATION#

工作线程不支持所请求的功能。

ERR_ZLIB_INITIALIZATION_FAILED#

由于配置不正确，创建 zlib 对象失败。

ERR_ZSTD_INVALID_PARAM#

在构建 Zstd 流期间传递了无效的参数键。

HPE_CHUNK_EXTENSIONS_OVERFLOW#

分块扩展收到的数据太多。为了防范恶意或配置错误的客户端，如果收到的数据超过 16 KiB，则会发出带有此代码的 Error。

HPE_HEADER_OVERFLOW#

收到了太多的 HTTP 标头数据。为了防范恶意或配置错误的客户端，如果收到的 HTTP 标头数据超过 maxHeaderSize，则 HTTP 解析将中止，且不会创建请求或响应对象，并会发出带有此代码的 Error。

HPE_UNEXPECTED_CONTENT_LENGTH#

服务器正在同时发送 Content-Length 标头和 Transfer-Encoding: chunked。

Transfer-Encoding: chunked 允许服务器为动态生成的内容维护 HTTP 持久连接。在这种情况下，无法使用 Content-Length HTTP 标头。

请使用 Content-Length 或 Transfer-Encoding: chunked。

MODULE_NOT_FOUND#

CommonJS 模块加载器在尝试 require() 操作或加载程序入口点时，无法解析模块文件。

遗留 Node.js 错误代码#

ERR_CANNOT_TRANSFER_OBJECT#

传递给 postMessage() 的值包含一个不支持传输的对象。

ERR_CPU_USAGE#

无法处理来自 process.cpuUsage 的原生调用。

ERR_CRYPTO_HASH_DIGEST_NO_UTF16#

在 hash.digest() 中使用了 UTF-16 编码。虽然 hash.digest() 方法允许传入 encoding 参数，使该方法返回字符串而不是 Buffer，但不支持 UTF-16 编码（例如 ucs 或 utf16le）。

ERR_CRYPTO_SCRYPT_INVALID_PARAMETER#

传递给 crypto.scrypt() 或 crypto.scryptSync() 的选项组合不兼容。新版本的 Node.js 改用错误代码 ERR_INCOMPATIBLE_OPTION_PAIR，这与其他 API 保持一致。

ERR_FS_INVALID_SYMLINK_TYPE#

向 fs.symlink() 或 fs.symlinkSync() 方法传递了无效的符号链接类型。

ERR_HTTP2_FRAME_ERROR#

在 HTTP/2 会话上发送单个帧失败时使用。

ERR_HTTP2_HEADERS_OBJECT#

在预期传入 HTTP/2 Headers 对象时使用。

ERR_HTTP2_HEADER_REQUIRED#

在 HTTP/2 消息中缺少必需的头部时使用。

ERR_HTTP2_INFO_HEADERS_AFTER_RESPOND#

HTTP/2 信息性头部必须仅在调用 Http2Stream.prototype.respond() 方法之前发送。

ERR_HTTP2_STREAM_CLOSED#

在已关闭的 HTTP/2 流上执行操作时使用。

ERR_HTTP_INVALID_CHAR#

在 HTTP 响应状态消息（原因短语）中发现无效字符时使用。

ERR_IMPORT_ASSERTION_TYPE_FAILED#

导入断言失败，导致无法导入指定的模块。

ERR_IMPORT_ASSERTION_TYPE_MISSING#

缺少导入断言，导致无法导入指定的模块。

ERR_IMPORT_ASSERTION_TYPE_UNSUPPORTED#

当前版本的 Node.js 不支持导入属性。

ERR_INDEX_OUT_OF_RANGE#

给定的索引超出了接受范围（例如负偏移量）。

ERR_INVALID_OPT_VALUE#

在选项对象中传递了无效或意外的值。

ERR_INVALID_OPT_VALUE_ENCODING#

传递了无效或未知的文件编码。

ERR_INVALID_PERFORMANCE_MARK#

在使用 Performance Timing API (perf_hooks) 时，性能标记无效。

ERR_INVALID_TRANSFER_OBJECT#

向 postMessage() 传递了无效的传输对象。

ERR_MANIFEST_ASSERT_INTEGRITY#

尝试加载资源，但资源不符合策略清单中定义的完整性。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_DEPENDENCY_MISSING#

尝试加载资源，但该资源未在尝试加载它的位置列为依赖项。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_INTEGRITY_MISMATCH#

尝试加载策略清单，但清单中针对某个资源的多个条目不匹配。更新清单条目以使其匹配以解决此错误。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_INVALID_RESOURCE_FIELD#

策略清单资源的一个字段的值无效。更新清单条目以使其匹配以解决此错误。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_INVALID_SPECIFIER#

策略清单资源的一个依赖映射的值无效。更新清单条目以使其匹配以解决此错误。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_PARSE_POLICY#

尝试加载策略清单，但无法解析该清单。有关更多信息，请参阅策略清单的文档。

ERR_MANIFEST_TDZ#

尝试从策略清单读取，但尚未进行清单初始化。这很可能是 Node.js 中的一个 bug。

ERR_MANIFEST_UNKNOWN_ONERROR#

加载了策略清单，但其 "onerror" 行为的值未知。有关更多信息，请参阅策略清单的文档。

ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST#

此错误代码在 Node.js 15.0.0 中被 ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST 取代，因为它不再准确，因为现在也存在其他类型的可传输对象。

ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST#

一个需要在 transferList 参数中显式列出的对象被传递给了 postMessage() 调用，但未在调用的 transferList 中提供。通常，这是一个 MessagePort。

在 v15.0.0 之前的 Node.js 版本中，这里使用的错误代码是 ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST。然而，可传输对象类型的集合已扩展，涵盖了比 MessagePort 更多的类型。

ERR_NAPI_CONS_PROTOTYPE_OBJECT#

当 Constructor.prototype 不是对象时，由 Node-API 使用。

ERR_NAPI_TSFN_START_IDLE_LOOP#

在主线程上，值会在空闲循环中从与线程安全函数关联的队列中移除。此错误表明在尝试启动循环时发生了错误。

ERR_NAPI_TSFN_STOP_IDLE_LOOP#

一旦队列中没有剩余项目，空闲循环必须挂起。此错误表明空闲循环停止失败。

ERR_NO_LONGER_SUPPORTED#

以不受支持的方式调用了 Node.js API，例如 Buffer.write(string, encoding, offset[, length])。

ERR_OUTOFMEMORY#

通用地用于标识操作导致了内存不足情况。

ERR_PARSE_HISTORY_DATA#

node:repl 模块无法从 REPL 历史记录文件中解析数据。

ERR_SOCKET_CANNOT_SEND#

数据无法在套接字上发送。

ERR_STDERR_CLOSE#

尝试关闭 process.stderr 流。按设计，Node.js 不允许用户代码关闭 stdout 或 stderr 流。

ERR_STDOUT_CLOSE#

尝试关闭 process.stdout 流。按设计，Node.js 不允许用户代码关闭 stdout 或 stderr 流。

ERR_STREAM_READ_NOT_IMPLEMENTED#

当尝试使用未实现 readable._read() 的可读流时使用。

ERR_TAP_LEXER_ERROR#

表示词法分析器状态失败的错误。

ERR_TAP_PARSER_ERROR#

表示解析器状态失败的错误。有关导致错误的标记的更多信息，可通过 cause 属性获得。

ERR_TAP_VALIDATION_ERROR#

此错误表示 TAP 验证失败。

ERR_TLS_RENEGOTIATION_FAILED#

当 TLS 协商请求以非特定方式失败时使用。

ERR_TRANSFERRING_EXTERNALIZED_SHAREDARRAYBUFFER#

在序列化期间遇到了内存不由 JavaScript 引擎或 Node.js 管理的 SharedArrayBuffer。这样的 SharedArrayBuffer 无法序列化。

这种情况仅在原生插件以“外部化”模式创建 SharedArrayBuffer，或者将现有的 SharedArrayBuffer 置于外部化模式时才会发生。

ERR_UNKNOWN_STDIN_TYPE#

尝试以未知的 stdin 文件类型启动 Node.js 进程。此错误通常表明 Node.js 本身存在 bug，尽管用户代码也有可能触发它。

ERR_UNKNOWN_STREAM_TYPE#

尝试以未知的 stdout 或 stderr 文件类型启动 Node.js 进程。此错误通常表明 Node.js 本身存在 bug，尽管用户代码也有可能触发它。

ERR_V8BREAKITERATOR#

使用了 V8 BreakIterator API，但未安装完整的 ICU 数据集。

ERR_VALUE_OUT_OF_RANGE#

当给定的值超出接受范围时使用。

ERR_VM_MODULE_LINKING_ERRORED#

链接器函数返回了一个链接失败的模块。

ERR_VM_MODULE_NOT_LINKED#

模块必须在实例化之前成功链接。

ERR_WORKER_UNSUPPORTED_EXTENSION#

用于工作线程主脚本的路径名具有未知的文件扩展名。

ERR_ZLIB_BINDING_CLOSED#

当尝试在 zlib 对象关闭后使用它时使用。

OpenSSL 错误代码#

时间有效性错误#

CERT_NOT_YET_VALID#

证书尚未生效：notBefore 日期晚于当前时间。

CERT_HAS_EXPIRED#

证书已过期：notAfter 日期早于当前时间。

CRL_NOT_YET_VALID#

证书吊销列表 (CRL) 的发布日期在未来。

CRL_HAS_EXPIRED#

证书吊销列表 (CRL) 已过期。

CERT_REVOKED#

证书已被吊销；它在证书吊销列表 (CRL) 中。

信任或链相关错误#

UNABLE_TO_GET_ISSUER_CERT#

找不到所查找证书的颁发者证书。这通常意味着受信任的证书列表不完整。

UNABLE_TO_GET_ISSUER_CERT_LOCALLY#

证书的颁发者未知。如果颁发者未包含在受信任的证书列表中，则会出现此情况。

DEPTH_ZERO_SELF_SIGNED_CERT#

传递的证书是自签名的，并且在受信任的证书列表中找不到相同的证书。

SELF_SIGNED_CERT_IN_CHAIN#

证书的颁发者未知。如果颁发者未包含在受信任的证书列表中，则会出现此情况。

CERT_CHAIN_TOO_LONG#

证书链长度大于最大深度。

UNABLE_TO_GET_CRL#

找不到证书引用的 CRL。

UNABLE_TO_VERIFY_LEAF_SIGNATURE#

由于链仅包含一个证书且它不是自签名的，因此无法验证任何签名。

CERT_UNTRUSTED#

根证书颁发机构 (CA) 未标记为受指定用途信任。

基本扩展错误#

INVALID_CA#

CA 证书无效。它要么不是 CA，要么其扩展与提供的用途不一致。

PATH_LENGTH_EXCEEDED#

已超过 basicConstraints pathlength 参数。

名称相关错误#

HOSTNAME_MISMATCH#

证书与提供的名称不匹配。

使用和策略错误#

INVALID_PURPOSE#

提供的证书不能用于指定用途。

CERT_REJECTED#

根 CA 被标记为拒绝指定用途。

格式错误#

CERT_SIGNATURE_FAILURE#

证书的签名无效。

CRL_SIGNATURE_FAILURE#

证书吊销列表 (CRL) 的签名无效。

ERROR_IN_CERT_NOT_BEFORE_FIELD#

证书 notBefore 字段包含无效时间。

ERROR_IN_CERT_NOT_AFTER_FIELD#

证书 notAfter 字段包含无效时间。

ERROR_IN_CRL_LAST_UPDATE_FIELD#

CRL lastUpdate 字段包含无效时间。

ERROR_IN_CRL_NEXT_UPDATE_FIELD#

CRL nextUpdate 字段包含无效时间。

UNABLE_TO_DECRYPT_CERT_SIGNATURE#

无法解密证书签名。这意味着无法确定实际的签名值，而不是它与预期值不匹配，这仅对 RSA 密钥有意义。

UNABLE_TO_DECRYPT_CRL_SIGNATURE#

无法解密证书吊销列表 (CRL) 签名：这意味着无法确定实际的签名值，而不是它与预期值不匹配。

UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY#

无法读取证书 SubjectPublicKeyInfo 中的公钥。

其他 OpenSSL 错误#

OUT_OF_MEM#

尝试分配内存时发生错误。这绝不应该发生。