Skip to content

Fehler

Anwendungen, die in Node.js laufen, erleben im Allgemeinen vier Kategorien von Fehlern:

  • Standard JavaScript-Fehler wie <EvalError>, <SyntaxError>, <RangeError>, <ReferenceError>, <TypeError> und <URIError>.
  • Systemfehler, die durch Einschränkungen des zugrunde liegenden Betriebssystems ausgelöst werden, z. B. der Versuch, eine Datei zu öffnen, die nicht existiert, oder der Versuch, Daten über eine geschlossene Socket zu senden.
  • Benutzerdefinierte Fehler, die durch den Anwendungscode ausgelöst werden.
  • AssertionErrors sind eine spezielle Fehlerklasse, die ausgelöst werden kann, wenn Node.js eine Ausnahmeverletzung der Logik erkennt, die niemals auftreten sollte. Diese werden in der Regel vom Modul node:assert ausgelöst.

Alle JavaScript- und Systemfehler, die von Node.js ausgelöst werden, erben von der Standard-JavaScript-Klasse <Error> oder sind Instanzen davon und garantieren mindestens die Eigenschaften, die in dieser Klasse verfügbar sind.

Fehlerweitergabe und -abfang

Node.js unterstützt mehrere Mechanismen zur Weitergabe und Behandlung von Fehlern, die während der Ausführung einer Anwendung auftreten. Wie diese Fehler gemeldet und behandelt werden, hängt vollständig vom Typ des Error und dem Stil der aufgerufenen API ab.

Alle JavaScript-Fehler werden als Ausnahmen behandelt, die sofort einen Fehler mit dem Standard-JavaScript-Mechanismus throw generieren und auslösen. Diese werden mit dem vom JavaScript-Sprachumfang bereitgestellten Konstrukt try…catch behandelt.

js
// Löst einen ReferenceError aus, da z nicht definiert ist.
try {
  const m = 1
  const n = m + z
} catch (err) {
  // Fehler hier behandeln.
}

Jede Verwendung des JavaScript-Mechanismus throw löst eine Ausnahme aus, die behandelt werden muss, sonst beendet der Node.js-Prozess sofort die Ausführung.

Mit wenigen Ausnahmen verwenden synchron APIs (jede blockierende Methode, die kein <Promise> zurückgibt oder eine callback-Funktion akzeptiert, wie z. B. fs.readFileSync), throw, um Fehler zu melden.

Fehler, die innerhalb von asynchronen APIs auftreten, können auf verschiedene Weise gemeldet werden:

  • Einige asynchrone Methoden geben ein <Promise> zurück. Man sollte immer berücksichtigen, dass es abgelehnt werden könnte. Siehe Flag --unhandled-rejections für die Reaktion des Prozesses auf eine nicht behandelte Promise-Ablehnung.
  • Die meisten asynchronen Methoden, die eine callback-Funktion akzeptieren, akzeptieren ein Error-Objekt, das als erstes Argument an diese Funktion übergeben wird. Wenn dieses erste Argument nicht null ist und eine Instanz von Error ist, ist ein Fehler aufgetreten, der behandelt werden sollte.
  • Wenn eine asynchrone Methode für ein Objekt aufgerufen wird, das ein EventEmitter ist, können Fehler an das Ereignis 'error' dieses Objekts weitergeleitet werden.
  • Eine Handvoll typischerweise asynchroner Methoden in der Node.js-API kann den Mechanismus throw weiterhin verwenden, um Ausnahmen auszulösen, die mit try…catch behandelt werden müssen. Es gibt keine umfassende Liste solcher Methoden; bitte beachten Sie die Dokumentation jeder Methode, um den entsprechenden Fehlerbehandlungsmechanismus zu bestimmen.

Die Verwendung des Mechanismus des Ereignisses 'error' ist am häufigsten für stream-basierte und Ereignis-Emitter-basierte APIs, die selbst eine Reihe von asynchronen Operationen im Laufe der Zeit darstellen (im Gegensatz zu einer einzelnen Operation, die erfolgreich sein oder fehlschlagen kann).

Für alle EventEmitter-Objekte wird der Fehler ausgelöst, wenn kein 'error'-Ereignis-Handler bereitgestellt wird, wodurch der Node.js-Prozess eine nicht abgefangene Ausnahme meldet und abstürzt, es sei denn: ein Handler wurde für das Ereignis 'uncaughtException' registriert oder das veraltete Modul node:domain wird verwendet.

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

setImmediate(() => {
  // Dies führt zum Absturz des Prozesses, da kein 'error'-Ereignis-
  // Handler hinzugefügt wurde.
  ee.emit('error', new Error('Dies führt zum Absturz'))
})

Auf diese Weise generierte Fehler können nicht mit try…catch abgefangen werden, da sie nach dem Verlassen des aufrufenden Codes ausgelöst werden.

Entwickler müssen in der Dokumentation jeder Methode nachsehen, um genau zu bestimmen, wie von diesen Methoden ausgelöste Fehler weitergegeben werden.

Klasse: Error

Ein generisches JavaScript <Error>-Objekt, das keinen spezifischen Umstand darüber angibt, warum der Fehler aufgetreten ist. Error-Objekte erfassen eine "Stack-Trace", die den Punkt im Code detailliert beschreibt, an dem der Error instanziiert wurde, und können eine Textbeschreibung des Fehlers liefern.

Alle von Node.js generierten Fehler, einschließlich aller System- und JavaScript-Fehler, sind entweder Instanzen der Klasse Error oder erben von ihr.

new Error(message[, options])

Erstellt ein neues Error-Objekt und setzt die Eigenschaft error.message auf die bereitgestellte Textnachricht. Wenn ein Objekt als message übergeben wird, wird die Textnachricht durch Aufrufen von String(message) generiert. Wenn die Option cause bereitgestellt wird, wird sie der Eigenschaft error.cause zugewiesen. Die Eigenschaft error.stack stellt den Punkt im Code dar, an dem new Error() aufgerufen wurde. Stack-Traces hängen von der V8 Stack-Trace API ab. Stack-Traces erstrecken sich nur bis entweder (a) zum Beginn der synchronen Codeausführung oder (b) zur Anzahl der Frames, die durch die Eigenschaft Error.stackTraceLimit angegeben werden, je nachdem, welcher Wert kleiner ist.

Error.captureStackTrace(targetObject[, constructorOpt])

Erstellt eine .stack-Eigenschaft für targetObject, die beim Zugriff eine Zeichenkette zurückgibt, die den Ort im Code darstellt, an dem Error.captureStackTrace() aufgerufen wurde.

js
const myObject = {}
Error.captureStackTrace(myObject)
myObject.stack // Ähnlich wie `new Error().stack`

Die erste Zeile des Trace wird mit ${myObject.name}: ${myObject.message} vorangestellt.

Das optionale Argument constructorOpt akzeptiert eine Funktion. Wenn angegeben, werden alle Frames über constructorOpt, einschließlich constructorOpt, aus dem generierten Stack-Trace ausgelassen.

Das Argument constructorOpt ist nützlich, um Implementierungsdetails der Fehlergenerierung vor dem Benutzer zu verbergen. Beispielsweise:

js
function a() {
  b()
}

function b() {
  c()
}

function c() {
  // Erstellt einen Fehler ohne Stack-Trace, um die doppelte Berechnung des Stack-Traces zu vermeiden.
  const { stackTraceLimit } = Error
  Error.stackTraceLimit = 0
  const error = new Error()
  Error.stackTraceLimit = stackTraceLimit

  // Erfasst den Stack-Trace oberhalb der Funktion b
  Error.captureStackTrace(error, b) // Weder Funktion c noch b ist im Stack-Trace enthalten
  throw error
}

a()

Error.stackTraceLimit

Die Eigenschaft Error.stackTraceLimit gibt die Anzahl der Stack-Frames an, die von einer Stack-Trace gesammelt werden (ob durch new Error().stack oder Error.captureStackTrace(obj) generiert).

Der Standardwert ist 10, kann aber auf jede gültige JavaScript-Zahl gesetzt werden. Änderungen wirken sich auf alle Stack-Traces aus, die nach der Änderung des Werts erfasst werden.

Wird ein Nicht-Zahlenwert oder eine negative Zahl gesetzt, erfassen Stack-Traces keine Frames.

error.cause

Hinzugefügt in: v16.9.0

Falls vorhanden, ist die Eigenschaft error.cause die zugrunde liegende Ursache des Fehlers (Error). Sie wird verwendet, wenn ein Fehler abgefangen und ein neuer mit einer anderen Meldung oder einem anderen Code ausgelöst wird, um dennoch Zugriff auf den ursprünglichen Fehler zu haben.

Die Eigenschaft error.cause wird typischerweise durch Aufrufen von new Error(message, { cause }) gesetzt. Sie wird vom Konstruktor nicht gesetzt, wenn die Option cause nicht angegeben wird.

Diese Eigenschaft ermöglicht das Verketten von Fehlern. Beim Serialisieren von Error-Objekten serialisiert util.inspect() error.cause rekursiv, wenn es gesetzt ist.

js
const cause = new Error('Der remote HTTP-Server hat mit einem 500-Status geantwortet')
const symptom = new Error('Die Nachricht konnte nicht gesendet werden', { cause })

console.log(symptom)
// Gibt aus:
//   Error: Die Nachricht konnte nicht gesendet werden
//       at REPL2:1:17
//       at Script.runInThisContext (node:vm:130:12)
//       ... 7 Zeilen passend zur cause Stack Trace ...
//       at [_line] [as _line] (node:internal/readline/interface:886:18) {
//     [cause]: Error: Der remote HTTP-Server hat mit einem 500-Status geantwortet
//         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)

error.code

Die Eigenschaft error.code ist ein String-Label, das die Art des Fehlers identifiziert. error.code ist die stabilste Methode zur Identifizierung eines Fehlers. Sie ändert sich nur zwischen Hauptversionen von Node.js. Im Gegensatz dazu können sich error.message-Strings zwischen beliebigen Versionen von Node.js ändern. Einzelheiten zu spezifischen Codes finden Sie unter Node.js-Fehlercodes.

error.message

Die Eigenschaft error.message ist die String-Beschreibung des Fehlers, wie sie durch den Aufruf von new Error(message) festgelegt wird. Die an den Konstruktor übergebene message erscheint auch in der ersten Zeile der Stack-Trace des Error. Das Ändern dieser Eigenschaft, nachdem das Error-Objekt erstellt wurde, kann jedoch die erste Zeile des Stack-Trace nicht ändern (z. B. wenn error.stack gelesen wird, bevor diese Eigenschaft geändert wird).

js
const err = new Error('Die Nachricht')
console.error(err.message)
// Gibt aus: Die Nachricht

error.stack

Die Eigenschaft error.stack ist ein String, der den Punkt im Code beschreibt, an dem der Error instanziiert wurde.

bash
Error: Dinge passieren immer wieder!
   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)

Die erste Zeile wird als \<Fehlerklassenname\>: \<Fehlermeldung\> formatiert und wird gefolgt von einer Reihe von Stack-Frames (jede Zeile beginnt mit "at "). Jeder Frame beschreibt eine Aufrufstelle im Code, die zum Auftreten des Fehlers geführt hat. V8 versucht, einen Namen für jede Funktion anzuzeigen (nach Variablenname, Funktionsname oder Objektmethodenname), aber gelegentlich kann es keinen geeigneten Namen finden. Wenn V8 keinen Namen für die Funktion ermitteln kann, werden für diesen Frame nur Standortinformationen angezeigt. Andernfalls wird der ermittelte Funktionsname mit angehängten Standortinformationen in Klammern angezeigt.

Frames werden nur für JavaScript-Funktionen generiert. Wenn beispielsweise die Ausführung synchron durch eine C++-Addon-Funktion namens cheetahify läuft, die selbst eine JavaScript-Funktion aufruft, ist der Frame, der den cheetahify-Aufruf darstellt, nicht in den Stack-Traces vorhanden:

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

function makeFaster() {
  // `cheetahify()` ruft *synchron* speedy auf.
  cheetahify(function speedy() {
    throw new Error('oh nein!')
  })
}

makeFaster()
// wird werfen:
//   /home/gbusey/file.js:6
//       throw new Error('oh nein!');
//           ^
//   Error: oh nein!
//       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

Die Standortinformationen lauten wie folgt:

  • native, wenn der Frame einen internen Aufruf in V8 darstellt (wie in [].forEach).
  • plain-filename.js:line:column, wenn der Frame einen internen Aufruf in Node.js darstellt.
  • /absolute/path/to/file.js:line:column, wenn der Frame einen Aufruf in einem Benutzerprogramm (unter Verwendung des CommonJS-Modulsystems) oder dessen Abhängigkeiten darstellt.
  • \<transport-protocol\>:///url/to/module/file.mjs:line:column, wenn der Frame einen Aufruf in einem Benutzerprogramm (unter Verwendung des ES-Modulsystems) oder dessen Abhängigkeiten darstellt.

Der String, der den Stack-Trace darstellt, wird träge generiert, wenn auf die Eigenschaft error.stack zugegriffen wird.

Die Anzahl der vom Stack-Trace erfassten Frames ist durch die kleinere von Error.stackTraceLimit oder die Anzahl der verfügbaren Frames im aktuellen Event-Loop-Tick begrenzt.

Klasse: AssertionError

Gibt das Fehlschlagen einer Assertion an. Details finden Sie unter Klasse: assert.AssertionError.

Klasse: RangeError

Gibt an, dass ein angegebenes Argument nicht innerhalb des festgelegten Bereichs oder der Reihe zulässiger Werte für eine Funktion lag; ob es sich dabei um einen numerischen Bereich handelt oder außerhalb der Optionsmenge für einen gegebenen Funktionsparameter liegt.

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

Node.js generiert und wirft RangeError-Instanzen sofort als Form der Argumentvalidierung.

Klasse: ReferenceError

Gibt an, dass versucht wird, auf eine Variable zuzugreifen, die nicht definiert ist. Solche Fehler deuten häufig auf Tippfehler im Code oder ein anderweitig fehlerhaftes Programm hin.

Während Clientcode diese Fehler generieren und weitergeben kann, wird dies in der Praxis nur von V8 durchgeführt.

js
doesNotExist
// Wirft ReferenceError, doesNotExist ist keine Variable in diesem Programm.

Sofern eine Anwendung keinen Code dynamisch generiert und ausführt, weisen ReferenceError-Instanzen auf einen Fehler im Code oder seinen Abhängigkeiten hin.

Klasse: SyntaxError

Gibt an, dass ein Programm kein gültiges JavaScript ist. Diese Fehler können nur als Ergebnis der Codeauswertung generiert und weitergegeben werden. Die Codeauswertung kann als Ergebnis von eval, Function, require oder vm erfolgen. Diese Fehler sind fast immer ein Hinweis auf ein fehlerhaftes Programm.

js
try {
  require('node:vm').runInThisContext('binary ! isNotOk')
} catch (err) {
  // 'err' wird ein SyntaxError sein.
}

SyntaxError-Instanzen sind im Kontext, der sie erstellt hat, nicht wiederherstellbar – sie können nur von anderen Kontexten abgefangen werden.

Klasse: SystemError

Node.js generiert Systemfehler, wenn Ausnahmen in seiner Laufzeitumgebung auftreten. Dies geschieht normalerweise, wenn eine Anwendung eine Einschränkung des Betriebssystems verletzt. Beispielsweise tritt ein Systemfehler auf, wenn eine Anwendung versucht, eine Datei zu lesen, die nicht existiert.

  • address <string> Falls vorhanden, die Adresse, mit der eine Netzwerkverbindung fehlgeschlagen ist
  • code <string> Der String-Fehlercode
  • dest <string> Falls vorhanden, der Dateipfad-Zielort bei der Meldung eines Dateisystemfehlers
  • errno <number> Die vom System bereitgestellte Fehlernummer
  • info <Object> Falls vorhanden, zusätzliche Details zum Fehlerzustand
  • message <string> Eine vom System bereitgestellte, menschenlesbare Beschreibung des Fehlers
  • path <string> Falls vorhanden, der Dateipfad bei der Meldung eines Dateisystemfehlers
  • port <number> Falls vorhanden, der Netzwerkverbindungsport, der nicht verfügbar ist
  • syscall <string> Der Name des Systemaufrufs, der den Fehler ausgelöst hat

error.address

Falls vorhanden, ist error.address eine Zeichenkette, die die Adresse beschreibt, mit der eine Netzwerkverbindung fehlgeschlagen ist.

error.code

Die Eigenschaft error.code ist eine Zeichenkette, die den Fehlercode darstellt.

error.dest

Falls vorhanden, ist error.dest der Dateipfad des Ziels bei der Meldung eines Dateisystemfehlers.

error.errno

Die Eigenschaft error.errno ist eine negative Zahl, die dem in libuv Error handling definierten Fehlercode entspricht.

Unter Windows wird die vom System bereitgestellte Fehlernummer von libuv normalisiert.

Um die Zeichenketten-Darstellung des Fehlercodes zu erhalten, verwenden Sie util.getSystemErrorName(error.errno).

error.info

Falls vorhanden, ist error.info ein Objekt mit Details zum Fehlerzustand.

error.message

error.message ist eine vom System bereitgestellte, menschenlesbare Beschreibung des Fehlers.

error.path

Falls vorhanden, ist error.path eine Zeichenkette, die einen relevanten ungültigen Dateinamen enthält.

error.port

Falls vorhanden, ist error.port der Netzwerkverbindungsport, der nicht verfügbar ist.

error.syscall

Die Eigenschaft error.syscall ist eine Zeichenkette, die den fehlgeschlagenen syscall beschreibt.

Häufige Systemfehler

Dies ist eine Liste von Systemfehlern, die beim Schreiben eines Node.js-Programms häufig auftreten. Eine umfassende Liste finden Sie auf der errno(3) Manpage.

  • EACCES (Zugriff verweigert): Es wurde versucht, auf eine Datei in einer Weise zuzugreifen, die durch ihre Datei-Zugriffsberechtigungen verboten ist.
  • EADDRINUSE (Adresse bereits in Verwendung): Der Versuch, einen Server (net, http oder https) an eine lokale Adresse zu binden, ist fehlgeschlagen, da ein anderer Server auf dem lokalen System diese Adresse bereits belegt.
  • ECONNREFUSED (Verbindung verweigert): Es konnte keine Verbindung hergestellt werden, weil die Zielmaschine sie aktiv verweigert hat. Dies ist in der Regel die Folge eines Versuchs, eine Verbindung zu einem Dienst herzustellen, der auf dem fremden Host inaktiv ist.
  • ECONNRESET (Verbindung vom Partner zurückgesetzt): Eine Verbindung wurde von einem Partner gewaltsam geschlossen. Dies ist normalerweise die Folge eines Verlusts der Verbindung auf dem Remote-Socket aufgrund eines Timeouts oder eines Neustarts. Häufig über die Module http und net aufgetreten.
  • EEXIST (Datei existiert): Eine vorhandene Datei war das Ziel einer Operation, die erforderte, dass das Ziel nicht existiert.
  • EISDIR (Ist ein Verzeichnis): Eine Operation erwartete eine Datei, aber der angegebene Dateiname war ein Verzeichnis.
  • EMFILE (Zu viele geöffnete Dateien im System): Die maximale Anzahl von Filedeskriptoren, die auf dem System zulässig sind, wurde erreicht, und Anfragen nach einem weiteren Deskriptor können erst erfüllt werden, wenn mindestens einer geschlossen wurde. Dies tritt auf, wenn viele Dateien gleichzeitig parallel geöffnet werden, insbesondere auf Systemen (insbesondere macOS), auf denen die Grenze für Filedeskriptoren für Prozesse niedrig ist. Um eine niedrige Grenze zu beheben, führen Sie ulimit -n 2048 in derselben Shell aus, die den Node.js-Prozess ausführt.
  • ENOENT (Keine solche Datei oder kein solches Verzeichnis): Wird häufig von fs-Operationen ausgelöst, um anzuzeigen, dass eine Komponente des angegebenen Dateinamens nicht existiert. Es konnte keine Entität (Datei oder Verzeichnis) über den angegebenen Pfad gefunden werden.
  • ENOTDIR (Kein Verzeichnis): Eine Komponente des angegebenen Dateinamens existierte, war aber nicht wie erwartet ein Verzeichnis. Häufig ausgelöst von fs.readdir.
  • ENOTEMPTY (Verzeichnis nicht leer): Ein Verzeichnis mit Einträgen war das Ziel einer Operation, die ein leeres Verzeichnis erfordert, normalerweise fs.unlink.
  • ENOTFOUND (DNS-Suche fehlgeschlagen): Zeigt einen DNS-Fehler von entweder EAI_NODATA oder EAI_NONAME an. Dies ist kein Standard-POSIX-Fehler.
  • EPERM (Operation nicht zulässig): Es wurde versucht, eine Operation durchzuführen, die erhöhte Berechtigungen erfordert.
  • EPIPE (Defekte Pipe): Ein Schreibvorgang auf eine Pipe, Socket oder FIFO, für die kein Prozess vorhanden ist, um die Daten zu lesen. Häufig auf den Ebenen net und http aufgetreten, was darauf hinweist, dass die Gegenstelle des zu beschreibenden Streams geschlossen wurde.
  • ETIMEDOUT (Operation ist zeitlich begrenzt): Eine Connect- oder Send-Anforderung ist fehlgeschlagen, weil die verbundene Partei nach einer bestimmten Zeit nicht ordnungsgemäß reagiert hat. In der Regel von http oder net aufgetreten. Oft ein Zeichen dafür, dass ein socket.end() nicht ordnungsgemäß aufgerufen wurde.

Klasse: TypeError

Gibt an, dass ein bereitgestelltes Argument kein zulässiger Typ ist. Das Übergeben einer Funktion an einen Parameter, der einen String erwartet, wäre beispielsweise ein TypeError.

js
require('node:url').parse(() => {})
// Wirft TypeError, da ein String erwartet wurde.

Node.js generiert und wirft TypeError-Instanzen sofort als Form der Argumentvalidierung.

Ausnahmen vs. Fehler

Eine JavaScript-Ausnahme ist ein Wert, der als Ergebnis einer ungültigen Operation oder als Ziel einer throw-Anweisung geworfen wird. Obwohl es nicht erforderlich ist, dass diese Werte Instanzen von Error oder Klassen sind, die von Error erben, sind alle von Node.js oder der JavaScript-Laufzeit geworfenen Ausnahmen werden Instanzen von Error sein.

Einige Ausnahmen sind auf der JavaScript-Ebene nicht wiederherstellbar. Solche Ausnahmen führen immer zum Absturz des Node.js-Prozesses. Beispiele hierfür sind assert()-Prüfungen oder abort()-Aufrufe in der C++-Schicht.

OpenSSL-Fehler

Fehler, die in crypto oder tls entstehen, gehören zur Klasse Error und können zusätzlich zu den Standard-Eigenschaften .code und .message einige zusätzliche OpenSSL-spezifische Eigenschaften haben.

error.opensslErrorStack

Ein Array von Fehlern, die Kontext darüber geben können, wo in der OpenSSL-Bibliothek ein Fehler entstanden ist.

error.function

Die OpenSSL-Funktion, in der der Fehler entstanden ist.

error.library

Die OpenSSL-Bibliothek, in der der Fehler entstanden ist.

error.reason

Eine menschenlesbare Zeichenkette, die den Grund für den Fehler beschreibt.

Node.js-Fehlercodes

ABORT_ERR

Hinzugefügt in: v15.0.0

Wird verwendet, wenn eine Operation abgebrochen wurde (typischerweise mit einem AbortController).

APIs, die keine AbortSignals verwenden, lösen normalerweise keinen Fehler mit diesem Code aus.

Dieser Code verwendet nicht die reguläre ERR_*-Konvention, die Node.js-Fehler verwenden, um mit dem AbortError der Webplattform kompatibel zu sein.

ERR_ACCESS_DENIED

Ein spezieller Fehlertyp, der ausgelöst wird, wenn Node.js versucht, auf eine durch das Berechtigungsmodell eingeschränkte Ressource zuzugreifen.

ERR_AMBIGUOUS_ARGUMENT

Ein Funktionsargument wird auf eine Weise verwendet, die darauf hindeutet, dass die Funktionssignatur falsch verstanden wurde. Dies wird vom Modul node:assert ausgelöst, wenn der Parameter message in assert.throws(block, message) mit der Fehlermeldung übereinstimmt, die von block ausgelöst wird, da diese Verwendung darauf hindeutet, dass der Benutzer glaubt, dass message die erwartete Meldung ist, anstatt die Meldung, die AssertionError anzeigt, wenn block keine Ausnahme auslöst.

ERR_ARG_NOT_ITERABLE

Es wurde ein iterierbares Argument (d. h. ein Wert, der mit for...of-Schleifen funktioniert) benötigt, aber nicht an eine Node.js-API übergeben.

ERR_ASSERTION

Ein spezieller Fehlertyp, der ausgelöst werden kann, wenn Node.js eine Ausnahme bei einer logischen Verletzung feststellt, die niemals auftreten sollte. Diese werden typischerweise vom Modul node:assert ausgelöst.

ERR_ASYNC_CALLBACK

Es wurde versucht, etwas, das keine Funktion ist, als AsyncHooks-Callback zu registrieren.

ERR_ASYNC_TYPE

Der Typ einer asynchronen Ressource war ungültig. Benutzer können auch ihre eigenen Typen definieren, wenn sie die öffentliche Embedder-API verwenden.

ERR_BROTLI_COMPRESSION_FAILED

An einen Brotli-Stream übergebene Daten konnten nicht erfolgreich komprimiert werden.

ERR_BROTLI_INVALID_PARAM

Beim Erstellen eines Brotli-Streams wurde ein ungültiger Parameterschlüssel übergeben.

ERR_BUFFER_CONTEXT_NOT_AVAILABLE

Es wurde versucht, eine Node.js Buffer-Instanz aus Addon- oder Embedder-Code zu erstellen, während sich der JS-Engine-Kontext nicht mit einer Node.js-Instanz verbindet. Die an die Buffer-Methode übergebenen Daten wurden zum Zeitpunkt der Rückgabe der Methode freigegeben.

Wenn dieser Fehler auftritt, ist eine mögliche Alternative zur Erstellung einer Buffer-Instanz die Erstellung eines normalen Uint8Array, der sich nur im Prototyp des resultierenden Objekts unterscheidet. Uint8Arrays werden in allen Node.js-Kern-APIs, in denen Buffers verwendet werden, allgemein akzeptiert; sie sind in allen Kontexten verfügbar.

ERR_BUFFER_OUT_OF_BOUNDS

Es wurde versucht, eine Operation außerhalb der Grenzen eines Buffer durchzuführen.

ERR_BUFFER_TOO_LARGE

Es wurde versucht, einen Buffer zu erstellen, der größer als die maximal zulässige Größe ist.

ERR_CANNOT_WATCH_SIGINT

Node.js konnte das SIGINT-Signal nicht überwachen.

ERR_CHILD_CLOSED_BEFORE_REPLY

Ein untergeordneter Prozess wurde geschlossen, bevor der übergeordnete Prozess eine Antwort erhalten hat.

ERR_CHILD_PROCESS_IPC_REQUIRED

Wird verwendet, wenn ein untergeordneter Prozess geforkt wird, ohne einen IPC-Kanal anzugeben.

ERR_CHILD_PROCESS_STDIO_MAXBUFFER

Wird verwendet, wenn der Hauptprozess versucht, Daten von STDERR/STDOUT des untergeordneten Prozesses zu lesen, und die Länge der Daten länger als die Option maxBuffer ist.

ERR_CLOSED_MESSAGE_PORT

[Verlauf]

VersionÄnderungen
v16.2.0, v14.17.1Die Fehlermeldung wurde wieder eingeführt.
v11.12.0Die Fehlermeldung wurde entfernt.
v10.5.0Hinzugefügt in: v10.5.0

Es wurde versucht, eine MessagePort-Instanz in einem geschlossenen Zustand zu verwenden, normalerweise nachdem .close() aufgerufen wurde.

ERR_CONSOLE_WRITABLE_STREAM

Console wurde ohne stdout-Stream instanziiert, oder Console hat einen nicht beschreibbaren stdout- oder stderr-Stream.

ERR_CONSTRUCT_CALL_INVALID

Hinzugefügt in: v12.5.0

Ein Klassenkonstruktor wurde aufgerufen, der nicht aufrufbar ist.

ERR_CONSTRUCT_CALL_REQUIRED

Ein Konstruktor für eine Klasse wurde ohne new aufgerufen.

ERR_CONTEXT_NOT_INITIALIZED

Der an die API übergebenen vm-Kontext wurde noch nicht initialisiert. Dies kann passieren, wenn während der Erstellung des Kontexts ein Fehler auftritt (und abgefangen wird), z. B. wenn die Zuweisung fehlschlägt oder die maximale Größe des Aufrufstapels beim Erstellen des Kontexts erreicht wird.

ERR_CRYPTO_CUSTOM_ENGINE_NOT_SUPPORTED

Eine OpenSSL-Engine wurde angefordert (z. B. über die TLS-Optionen clientCertEngine oder privateKeyEngine), die von der verwendeten OpenSSL-Version nicht unterstützt wird, wahrscheinlich aufgrund des Kompilierzeit-Flags OPENSSL_NO_ENGINE.

ERR_CRYPTO_ECDH_INVALID_FORMAT

Ein ungültiger Wert für das Argument format wurde an die Methode getPublicKey() der Klasse crypto.ECDH() übergeben.

ERR_CRYPTO_ECDH_INVALID_PUBLIC_KEY

Ein ungültiger Wert für das Argument key wurde an die Methode computeSecret() der Klasse crypto.ECDH() übergeben. Dies bedeutet, dass der öffentliche Schlüssel außerhalb der elliptischen Kurve liegt.

ERR_CRYPTO_ENGINE_UNKNOWN

Ein ungültiger Krypto-Engine-Bezeichner wurde an require('node:crypto').setEngine() übergeben.

ERR_CRYPTO_FIPS_FORCED

Das Kommandozeilenargument --force-fips wurde verwendet, aber es wurde versucht, den FIPS-Modus im node:crypto-Modul zu aktivieren oder zu deaktivieren.

ERR_CRYPTO_FIPS_UNAVAILABLE

Es wurde versucht, den FIPS-Modus zu aktivieren oder zu deaktivieren, aber der FIPS-Modus war nicht verfügbar.

ERR_CRYPTO_HASH_FINALIZED

hash.digest() wurde mehrmals aufgerufen. Die hash.digest()-Methode darf nicht mehr als einmal pro Instanz eines Hash-Objekts aufgerufen werden.

ERR_CRYPTO_HASH_UPDATE_FAILED

hash.update() ist aus irgendeinem Grund fehlgeschlagen. Dies sollte selten, wenn überhaupt, vorkommen.

ERR_CRYPTO_INCOMPATIBLE_KEY

Die angegebenen Krypto-Schlüssel sind nicht mit dem versuchten Vorgang kompatibel.

ERR_CRYPTO_INCOMPATIBLE_KEY_OPTIONS

Die ausgewählte Codierung für öffentliche oder private Schlüssel ist nicht mit anderen Optionen kompatibel.

ERR_CRYPTO_INITIALIZATION_FAILED

Hinzugefügt in: v15.0.0

Die Initialisierung des Kryptosubsystems ist fehlgeschlagen.

ERR_CRYPTO_INVALID_AUTH_TAG

Hinzugefügt in: v15.0.0

Ein ungültiges Authentifizierungstag wurde bereitgestellt.

ERR_CRYPTO_INVALID_COUNTER

Hinzugefügt in: v15.0.0

Ein ungültiger Zähler wurde für eine Chiffre im Zählermodus bereitgestellt.

ERR_CRYPTO_INVALID_CURVE

Hinzugefügt in: v15.0.0

Eine ungültige elliptische Kurve wurde bereitgestellt.

ERR_CRYPTO_INVALID_DIGEST

Ein ungültiger Krypto-Digest-Algorithmus wurde angegeben.

ERR_CRYPTO_INVALID_IV

Hinzugefügt in: v15.0.0

Ein ungültiger Initialisierungsvektor wurde bereitgestellt.

ERR_CRYPTO_INVALID_JWK

Hinzugefügt in: v15.0.0

Ein ungültiger JSON Web Key wurde bereitgestellt.

ERR_CRYPTO_INVALID_KEYLEN

Hinzugefügt in: v15.0.0

Eine ungültige Schlüssellänge wurde bereitgestellt.

ERR_CRYPTO_INVALID_KEYPAIR

Hinzugefügt in: v15.0.0

Ein ungültiges Schlüsselpaar wurde bereitgestellt.

ERR_CRYPTO_INVALID_KEYTYPE

Hinzugefügt in: v15.0.0

Ein ungültiger Schlüsseltyp wurde bereitgestellt.

ERR_CRYPTO_INVALID_KEY_OBJECT_TYPE

Der Typ des angegebenen Krypto-Schlüssel-Objekts ist für den versuchten Vorgang ungültig.

ERR_CRYPTO_INVALID_MESSAGELEN

Hinzugefügt in: v15.0.0

Eine ungültige Nachrichtenlänge wurde angegeben.

ERR_CRYPTO_INVALID_SCRYPT_PARAMS

Hinzugefügt in: v15.0.0

Ein oder mehrere Parameter von crypto.scrypt() oder crypto.scryptSync() liegen außerhalb ihres zulässigen Bereichs.

ERR_CRYPTO_INVALID_STATE

Eine Krypto-Methode wurde auf einem Objekt verwendet, das sich in einem ungültigen Zustand befand. Beispielsweise der Aufruf von cipher.getAuthTag() vor dem Aufruf von cipher.final().

ERR_CRYPTO_INVALID_TAG_LENGTH

Hinzugefügt in: v15.0.0

Eine ungültige Länge des Authentifizierungs-Tags wurde angegeben.

ERR_CRYPTO_JOB_INIT_FAILED

Hinzugefügt in: v15.0.0

Die Initialisierung eines asynchronen Krypto-Vorgangs ist fehlgeschlagen.

ERR_CRYPTO_JWK_UNSUPPORTED_CURVE

Die elliptische Kurve des Schlüssels ist nicht für die Verwendung im JSON Web Key Elliptic Curve Registry registriert.

ERR_CRYPTO_JWK_UNSUPPORTED_KEY_TYPE

Der asymmetrische Schlüsseltyp des Schlüssels ist nicht für die Verwendung im JSON Web Key Types Registry registriert.

ERR_CRYPTO_OPERATION_FAILED

Hinzugefügt in: v15.0.0

Ein Krypto-Vorgang ist aus einem anderweitig nicht näher spezifizierten Grund fehlgeschlagen.

ERR_CRYPTO_PBKDF2_ERROR

Der PBKDF2-Algorithmus ist aus nicht näher spezifizierten Gründen fehlgeschlagen. OpenSSL liefert keine weiteren Details, daher auch nicht Node.js.

ERR_CRYPTO_SCRYPT_NOT_SUPPORTED

Node.js wurde ohne scrypt-Unterstützung kompiliert. Nicht möglich mit den offiziellen Release-Binärdateien, kann aber bei benutzerdefinierten Builds, einschließlich Distro-Builds, vorkommen.

ERR_CRYPTO_SIGN_KEY_REQUIRED

Ein Signatur-key wurde der Methode sign.sign() nicht übergeben.

ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH

crypto.timingSafeEqual()](/de/api/crypto#cryptotimingsafeequala-b) wurde mit Buffer, TypedArray oder DataView-Argumenten unterschiedlicher Länge aufgerufen.

ERR_CRYPTO_UNKNOWN_CIPHER

Es wurde eine unbekannte Chiffre angegeben.

ERR_CRYPTO_UNKNOWN_DH_GROUP

Es wurde ein unbekannter Diffie-Hellman-Gruppenname angegeben. Eine Liste gültiger Gruppennamen finden Sie unter crypto.getDiffieHellman().

ERR_CRYPTO_UNSUPPORTED_OPERATION

Hinzugefügt in: v15.0.0, v14.18.0

Es wurde versucht, eine nicht unterstützte Krypto-Operation aufzurufen.

ERR_DEBUGGER_ERROR

Hinzugefügt in: v16.4.0, v14.17.4

Ein Fehler ist beim Debugger aufgetreten.

ERR_DEBUGGER_STARTUP_ERROR

Hinzugefügt in: v16.4.0, v14.17.4

Der Debugger hat beim Warten auf die Freigabe des erforderlichen Hosts/Ports ein Timeout erreicht.

ERR_DIR_CLOSED

Das fs.Dir wurde zuvor geschlossen.

ERR_DIR_CONCURRENT_OPERATION

Hinzugefügt in: v14.3.0

Ein synchroner Lese- oder Schließaufruf wurde auf einem fs.Dir versucht, bei dem asynchrone Operationen laufen.

ERR_DLOPEN_DISABLED

Hinzugefügt in: v16.10.0, v14.19.0

Das Laden von nativen Addons wurde mit --no-addons deaktiviert.

ERR_DLOPEN_FAILED

Hinzugefügt in: v15.0.0

Ein Aufruf von process.dlopen() ist fehlgeschlagen.

ERR_DNS_SET_SERVERS_FAILED

c-ares konnte den DNS-Server nicht setzen.

ERR_DOMAIN_CALLBACK_NOT_AVAILABLE

Das Modul node:domain war nicht verwendbar, da es die erforderlichen Fehlerbehandlungs-Hooks nicht einrichten konnte, weil process.setUncaughtExceptionCaptureCallback() zu einem früheren Zeitpunkt aufgerufen wurde.

ERR_DOMAIN_CANNOT_SET_UNCAUGHT_EXCEPTION_CAPTURE

process.setUncaughtExceptionCaptureCallback() konnte nicht aufgerufen werden, da das Modul node:domain zu einem früheren Zeitpunkt geladen wurde.

Die Stack-Trace wird erweitert, um den Zeitpunkt einzuschließen, zu dem das Modul node:domain geladen wurde.

ERR_DUPLICATE_STARTUP_SNAPSHOT_MAIN_FUNCTION

v8.startupSnapshot.setDeserializeMainFunction() konnte nicht aufgerufen werden, da es bereits zuvor aufgerufen wurde.

ERR_ENCODING_INVALID_ENCODED_DATA

Die an TextDecoder() API übergebenen Daten waren gemäß der angegebenen Kodierung ungültig.

ERR_ENCODING_NOT_SUPPORTED

Die an TextDecoder() API übergebene Kodierung gehörte nicht zu den WHATWG unterstützten Kodierungen.

ERR_EVAL_ESM_CANNOT_PRINT

--print kann nicht mit ESM-Eingabe verwendet werden.

ERR_EVENT_RECURSION

Wird ausgelöst, wenn versucht wird, ein Ereignis rekursiv auf EventTarget zu versenden.

ERR_EXECUTION_ENVIRONMENT_NOT_AVAILABLE

Der JS-Ausführungskontext ist nicht mit einer Node.js-Umgebung verknüpft. Dies kann auftreten, wenn Node.js als eingebettete Bibliothek verwendet wird und einige Hooks für die JS-Engine nicht korrekt eingerichtet sind.

ERR_FALSY_VALUE_REJECTION

Ein Promise, das über util.callbackify() callbackifiziert wurde, wurde mit einem falsy-Wert abgelehnt.

ERR_FEATURE_UNAVAILABLE_ON_PLATFORM

Hinzugefügt in: v14.0.0

Wird verwendet, wenn eine Funktion verwendet wird, die auf der aktuellen Plattform, auf der Node.js ausgeführt wird, nicht verfügbar ist.

ERR_FS_CP_DIR_TO_NON_DIR

Hinzugefügt in: v16.7.0

Es wurde versucht, ein Verzeichnis mit fs.cp() in ein Nicht-Verzeichnis (Datei, Symlink usw.) zu kopieren.

ERR_FS_CP_EEXIST

Hinzugefügt in: v16.7.0

Es wurde versucht, eine Datei zu kopieren, die bereits mit fs.cp() existierte, wobei force und errorOnExist auf true gesetzt waren.

ERR_FS_CP_EINVAL

Hinzugefügt in: v16.7.0

Bei Verwendung von fs.cp() zeigte src oder dest auf einen ungültigen Pfad.

ERR_FS_CP_FIFO_PIPE

Hinzugefügt in: v16.7.0

Es wurde versucht, eine Named Pipe mit fs.cp() zu kopieren.

ERR_FS_CP_NON_DIR_TO_DIR

Hinzugefügt in: v16.7.0

Es wurde versucht, ein Nicht-Verzeichnis (Datei, Symlink usw.) mit fs.cp() in ein Verzeichnis zu kopieren.

ERR_FS_CP_SOCKET

Hinzugefügt in: v16.7.0

Es wurde versucht, mit fs.cp() in eine Socket zu kopieren.

Hinzugefügt in: v16.7.0

Wenn fs.cp() verwendet wird, verweist ein symbolischer Link in dest auf ein Unterverzeichnis von src.

ERR_FS_CP_UNKNOWN

Hinzugefügt in: v16.7.0

Es wurde versucht, mit fs.cp() in einen unbekannten Dateityp zu kopieren.

ERR_FS_EISDIR

Pfad ist ein Verzeichnis.

ERR_FS_FILE_TOO_LARGE

Es wurde versucht, eine Datei zu lesen, deren Größe größer als die maximal zulässige Größe für einen Buffer ist.

ERR_HTTP2_ALTSVC_INVALID_ORIGIN

HTTP/2 ALTSVC-Frames erfordern einen gültigen Ursprung.

ERR_HTTP2_ALTSVC_LENGTH

HTTP/2 ALTSVC-Frames sind auf maximal 16.382 Nutzdaten-Bytes beschränkt.

ERR_HTTP2_CONNECT_AUTHORITY

Für HTTP/2-Anforderungen mit der Methode CONNECT ist der Pseudo-Header :authority erforderlich.

ERR_HTTP2_CONNECT_PATH

Für HTTP/2-Anforderungen mit der Methode CONNECT ist der Pseudo-Header :path verboten.

ERR_HTTP2_CONNECT_SCHEME

Für HTTP/2-Anforderungen mit der Methode CONNECT ist der Pseudo-Header :scheme verboten.

ERR_HTTP2_ERROR

Ein unspezifischer HTTP/2-Fehler ist aufgetreten.

ERR_HTTP2_GOAWAY_SESSION

Neue HTTP/2-Streams können nicht geöffnet werden, nachdem die Http2Session einen GOAWAY-Frame vom verbundenen Peer erhalten hat.

ERR_HTTP2_HEADERS_AFTER_RESPOND

Ein zusätzlicher Header wurde angegeben, nachdem eine HTTP/2-Antwort initiiert wurde.

ERR_HTTP2_HEADERS_SENT

Es wurde versucht, mehrere Antwort-Header zu senden.

ERR_HTTP2_HEADER_SINGLE_VALUE

Es wurden mehrere Werte für ein HTTP/2-Headerfeld angegeben, das nur einen einzigen Wert haben darf.

ERR_HTTP2_INFO_STATUS_NOT_ALLOWED

Informationelle HTTP-Statuscodes (1xx) dürfen nicht als Antwort-Statuscode bei HTTP/2-Antworten festgelegt werden.

ERR_HTTP2_INVALID_CONNECTION_HEADERS

HTTP/1-Verbindungsspezifische Header dürfen in HTTP/2-Anforderungen und -Antworten nicht verwendet werden.

ERR_HTTP2_INVALID_HEADER_VALUE

Ein ungültiger HTTP/2-Header-Wert wurde angegeben.

ERR_HTTP2_INVALID_INFO_STATUS

Es wurde ein ungültiger HTTP-Informationsstatuscode angegeben. Informationsstatuscodes müssen eine ganze Zahl zwischen 100 und 199 (einschließlich) sein.

ERR_HTTP2_INVALID_ORIGIN

HTTP/2 ORIGIN-Frames benötigen einen gültigen Ursprung.

ERR_HTTP2_INVALID_PACKED_SETTINGS_LENGTH

Eingabe Buffer und Uint8Array-Instanzen, die an die http2.getUnpackedSettings()-API übergeben werden, müssen eine Länge haben, die ein Vielfaches von sechs ist.

ERR_HTTP2_INVALID_PSEUDOHEADER

Es dürfen nur gültige HTTP/2-Pseudoheader (:status, :path, :authority, :scheme und :method) verwendet werden.

ERR_HTTP2_INVALID_SESSION

Eine Aktion wurde auf einem Http2Session-Objekt ausgeführt, das bereits zerstört wurde.

ERR_HTTP2_INVALID_SETTING_VALUE

Es wurde ein ungültiger Wert für eine HTTP/2-Einstellung angegeben.

ERR_HTTP2_INVALID_STREAM

Ein Vorgang wurde auf einem Stream ausgeführt, der bereits zerstört wurde.

ERR_HTTP2_MAX_PENDING_SETTINGS_ACK

Wenn ein HTTP/2 SETTINGS-Frame an einen verbundenen Peer gesendet wird, muss der Peer eine Bestätigung senden, dass er die neuen SETTINGS empfangen und angewendet hat. Standardmäßig kann eine maximale Anzahl nicht bestätigter SETTINGS-Frames zu einem beliebigen Zeitpunkt gesendet werden. Dieser Fehlercode wird verwendet, wenn dieses Limit erreicht wurde.

ERR_HTTP2_NESTED_PUSH

Es wurde versucht, einen neuen Push-Stream innerhalb eines Push-Streams zu initiieren. Verschachtelte Push-Streams sind nicht zulässig.

ERR_HTTP2_NO_MEM

Speichermangel bei Verwendung der http2session.setLocalWindowSize(windowSize)-API.

ERR_HTTP2_NO_SOCKET_MANIPULATION

Es wurde versucht, eine mit einer Http2Session verbundene Socket direkt zu manipulieren (lesen, schreiben, pausieren, fortsetzen usw.).

ERR_HTTP2_ORIGIN_LENGTH

HTTP/2 ORIGIN-Frames sind auf eine Länge von 16382 Bytes begrenzt.

ERR_HTTP2_OUT_OF_STREAMS

Die Anzahl der Streams, die in einer einzelnen HTTP/2-Sitzung erstellt wurden, hat das maximale Limit erreicht.

ERR_HTTP2_PAYLOAD_FORBIDDEN

Es wurde eine Nachrichtennutzlast für einen HTTP-Antwortcode angegeben, für den eine Nutzlast verboten ist.

ERR_HTTP2_PING_CANCEL

Ein HTTP/2-Ping wurde abgebrochen.

ERR_HTTP2_PING_LENGTH

HTTP/2-Ping-Payloads müssen genau 8 Byte lang sein.

ERR_HTTP2_PSEUDOHEADER_NOT_ALLOWED

Ein HTTP/2-Pseudo-Header wurde unangemessen verwendet. Pseudo-Header sind Header-Schlüsselnamen, die mit dem Präfix : beginnen.

ERR_HTTP2_PUSH_DISABLED

Es wurde versucht, einen Push-Stream zu erstellen, der vom Client deaktiviert wurde.

ERR_HTTP2_SEND_FILE

Es wurde versucht, die API Http2Stream.prototype.responseWithFile() zum Senden eines Verzeichnisses zu verwenden.

ERR_HTTP2_SEND_FILE_NOSEEK

Es wurde versucht, die API Http2Stream.prototype.responseWithFile() zum Senden von etwas anderem als einer regulären Datei zu verwenden, aber die Optionen offset oder length wurden bereitgestellt.

ERR_HTTP2_SESSION_ERROR

Die Http2Session wurde mit einem von Null verschiedenen Fehlercode geschlossen.

ERR_HTTP2_SETTINGS_CANCEL

Die Http2Session-Einstellungen wurden abgebrochen.

ERR_HTTP2_SOCKET_BOUND

Es wurde versucht, ein Http2Session-Objekt mit einem net.Socket oder tls.TLSSocket zu verbinden, das bereits an ein anderes Http2Session-Objekt gebunden war.

ERR_HTTP2_SOCKET_UNBOUND

Es wurde versucht, die socket-Eigenschaft einer Http2Session zu verwenden, die bereits geschlossen wurde.

ERR_HTTP2_STATUS_101

Die Verwendung des Informationsstatuscodes 101 ist in HTTP/2 verboten.

ERR_HTTP2_STATUS_INVALID

Es wurde ein ungültiger HTTP-Statuscode angegeben. Statuscodes müssen eine ganze Zahl zwischen 100 und 599 (inklusive) sein.

ERR_HTTP2_STREAM_CANCEL

Ein Http2Stream wurde zerstört, bevor Daten an den verbundenen Peer übertragen wurden.

ERR_HTTP2_STREAM_ERROR

In einem RST_STREAM-Frame wurde ein von Null verschiedener Fehlercode angegeben.

ERR_HTTP2_STREAM_SELF_DEPENDENCY

Beim Festlegen der Priorität für einen HTTP/2-Stream kann der Stream als Abhängigkeit für einen übergeordneten Stream markiert werden. Dieser Fehlercode wird verwendet, wenn versucht wird, einen Stream als von sich selbst abhängig zu markieren.

ERR_HTTP2_TOO_MANY_CUSTOM_SETTINGS

Die Anzahl der unterstützten benutzerdefinierten Einstellungen (10) wurde überschritten.

ERR_HTTP2_TOO_MANY_INVALID_FRAMES

Hinzugefügt in: v15.14.0

Die durch die Option maxSessionInvalidFrames festgelegte Grenze für akzeptable ungültige HTTP/2-Protokollframes, die vom Peer gesendet wurden, wurde überschritten.

ERR_HTTP2_TRAILERS_ALREADY_SENT

Nachlaufende Header wurden bereits an den Http2Stream gesendet.

ERR_HTTP2_TRAILERS_NOT_READY

Die Methode http2stream.sendTrailers() kann erst nach dem Emittieren des Ereignisses 'wantTrailers' an einem Http2Stream-Objekt aufgerufen werden. Das Ereignis 'wantTrailers' wird nur emittiert, wenn die Option waitForTrailers für den Http2Stream gesetzt ist.

ERR_HTTP2_UNSUPPORTED_PROTOCOL

http2.connect() wurde eine URL übergeben, die ein anderes Protokoll als http: oder https: verwendet.

ERR_HTTP_BODY_NOT_ALLOWED

Ein Fehler wird ausgelöst, wenn in eine HTTP-Antwort geschrieben wird, die keinen Inhalt zulässt.

ERR_HTTP_CONTENT_LENGTH_MISMATCH

Die Größe des Antwortkörpers stimmt nicht mit dem angegebenen Wert im Content-Length-Header überein.

ERR_HTTP_HEADERS_SENT

Es wurde versucht, weitere Header hinzuzufügen, nachdem die Header bereits gesendet wurden.

ERR_HTTP_INVALID_HEADER_VALUE

Ein ungültiger HTTP-Header-Wert wurde angegeben.

ERR_HTTP_INVALID_STATUS_CODE

Der Statuscode lag außerhalb des regulären Statuscodebereichs (100-999).

ERR_HTTP_REQUEST_TIMEOUT

Der Client hat die gesamte Anfrage nicht innerhalb der zulässigen Zeit gesendet.

ERR_HTTP_SOCKET_ASSIGNED

Dem gegebenen ServerResponse wurde bereits ein Socket zugewiesen.

ERR_HTTP_SOCKET_ENCODING

Das Ändern der Socket-Codierung ist gemäß RFC 7230 Abschnitt 3 nicht zulässig.

ERR_HTTP_TRAILER_INVALID

Der Header Trailer wurde gesetzt, obwohl die Transfer-Codierung dies nicht unterstützt.

ERR_ILLEGAL_CONSTRUCTOR

Es wurde versucht, ein Objekt mit einem nicht-öffentlichen Konstruktor zu erstellen.

ERR_IMPORT_ATTRIBUTE_MISSING

Hinzugefügt in: v21.1.0

Ein Importattribut fehlt, wodurch das Importieren des angegebenen Moduls verhindert wird.

ERR_IMPORT_ATTRIBUTE_TYPE_INCOMPATIBLE

Hinzugefügt in: v21.1.0

Es wurde ein type-Attribut für den Import angegeben, aber das angegebene Modul hat einen anderen Typ.

ERR_IMPORT_ATTRIBUTE_UNSUPPORTED

Hinzugefügt in: v21.0.0, v20.10.0, v18.19.0

Ein Importattribut wird von dieser Node.js-Version nicht unterstützt.

ERR_INCOMPATIBLE_OPTION_PAIR

Ein Optionenpaar ist inkompatibel und kann nicht gleichzeitig verwendet werden.

ERR_INPUT_TYPE_NOT_ALLOWED

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Das Flag --input-type wurde verwendet, um zu versuchen, eine Datei auszuführen. Dieses Flag kann nur mit Eingabe über --eval, --print oder STDIN verwendet werden.

ERR_INSPECTOR_ALREADY_ACTIVATED

Bei der Verwendung des Moduls node:inspector wurde versucht, den Inspector zu aktivieren, obwohl er bereits auf einem Port lauscht. Verwenden Sie inspector.close(), bevor Sie ihn an einer anderen Adresse aktivieren.

ERR_INSPECTOR_ALREADY_CONNECTED

Bei der Verwendung des Moduls node:inspector wurde versucht, eine Verbindung herzustellen, obwohl der Inspector bereits verbunden war.

ERR_INSPECTOR_CLOSED

Bei der Verwendung des Moduls node:inspector wurde versucht, den Inspector zu verwenden, nachdem die Sitzung bereits geschlossen wurde.

ERR_INSPECTOR_COMMAND

Ein Fehler ist beim Ausführen eines Befehls über das Modul node:inspector aufgetreten.

ERR_INSPECTOR_NOT_ACTIVE

Der inspector ist nicht aktiv, wenn inspector.waitForDebugger() aufgerufen wird.

ERR_INSPECTOR_NOT_AVAILABLE

Das Modul node:inspector steht nicht zur Verfügung.

ERR_INSPECTOR_NOT_CONNECTED

Bei der Verwendung des Moduls node:inspector wurde versucht, den Inspector zu verwenden, bevor er verbunden war.

ERR_INSPECTOR_NOT_WORKER

Eine API wurde im Hauptthread aufgerufen, die nur vom Worker-Thread verwendet werden kann.

ERR_INTERNAL_ASSERTION

Es gab einen Fehler in Node.js oder eine falsche Verwendung von Node.js-internen Funktionen. Um den Fehler zu beheben, öffnen Sie ein Issue unter https://github.com/nodejs/node/issues.

ERR_INVALID_ADDRESS

Die angegebene Adresse wird von der Node.js API nicht verstanden.

ERR_INVALID_ADDRESS_FAMILY

Die angegebene Adressfamilie wird von der Node.js API nicht verstanden.

ERR_INVALID_ARG_TYPE

Ein Argument vom falschen Typ wurde an eine Node.js API übergeben.

ERR_INVALID_ARG_VALUE

Ein ungültiger oder nicht unterstützter Wert wurde für ein gegebenes Argument übergeben.

ERR_INVALID_ASYNC_ID

Eine ungültige asyncId oder triggerAsyncId wurde mit AsyncHooks übergeben. Eine ID kleiner als -1 sollte niemals auftreten.

ERR_INVALID_BUFFER_SIZE

Ein Swap wurde auf einem Buffer durchgeführt, dessen Größe jedoch nicht mit der Operation kompatibel war.

ERR_INVALID_CHAR

Ungültige Zeichen wurden in den Headern erkannt.

ERR_INVALID_CURSOR_POS

Ein Cursor auf einem gegebenen Stream kann nicht ohne angegebene Spalte in eine angegebene Zeile verschoben werden.

ERR_INVALID_FD

Ein File Descriptor ('fd') war ungültig (z. B. ein negativer Wert).

ERR_INVALID_FD_TYPE

Ein File Descriptor ('fd')-Typ war ungültig.

ERR_INVALID_FILE_URL_HOST

Eine Node.js API, die file:-URLs verwendet (wie bestimmte Funktionen im Modul fs), hat eine Datei-URL mit einem inkompatiblen Host angetroffen. Diese Situation kann nur auf Unix-artigen Systemen auftreten, wo nur localhost oder ein leerer Host unterstützt wird.

ERR_INVALID_FILE_URL_PATH

Eine Node.js API, die file:-URLs verwendet (wie bestimmte Funktionen im Modul fs), hat eine Datei-URL mit einem inkompatiblen Pfad angetroffen. Die genaue Semantik zur Bestimmung, ob ein Pfad verwendet werden kann, ist plattformabhängig.

ERR_INVALID_HANDLE_TYPE

Es wurde versucht, ein nicht unterstütztes "Handle" über einen IPC-Kommunikationskanal an einen Child-Prozess zu senden. Siehe subprocess.send() und process.send() für weitere Informationen.

ERR_INVALID_HTTP_TOKEN

Ein ungültiges HTTP-Token wurde angegeben.

ERR_INVALID_IP_ADDRESS

Eine IP-Adresse ist ungültig.

ERR_INVALID_MIME_SYNTAX

Die Syntax eines MIME-Typs ist ungültig.

ERR_INVALID_MODULE

Hinzugefügt in: v15.0.0, v14.18.0

Es wurde versucht, ein Modul zu laden, das nicht existiert oder auf andere Weise ungültig ist.

ERR_INVALID_MODULE_SPECIFIER

Die importierte Modulzeichenkette ist eine ungültige URL, ein ungültiger Paketname oder ein ungültiger Paket-Unterpfad-Spezifizierer.

ERR_INVALID_OBJECT_DEFINE_PROPERTY

Ein Fehler ist beim Setzen eines ungültigen Attributs auf der Eigenschaft eines Objekts aufgetreten.

ERR_INVALID_PACKAGE_CONFIG

Eine ungültige package.json-Datei konnte nicht geparst werden.

ERR_INVALID_PACKAGE_TARGET

Das Feld "exports" in package.json enthält einen ungültigen Zielzuordnungswert für die versuchte Modulauflösung.

ERR_INVALID_PROTOCOL

Ein ungültiges options.protocol wurde an http.request() übergeben.

ERR_INVALID_REPL_EVAL_CONFIG

Sowohl die Optionen breakEvalOnSigint als auch eval wurden in der REPL-Konfiguration gesetzt, was nicht unterstützt wird.

ERR_INVALID_REPL_INPUT

Die Eingabe darf nicht in der REPL verwendet werden. Die Bedingungen, unter denen dieser Fehler auftritt, werden in der Dokumentation zur REPL beschrieben.

ERR_INVALID_RETURN_PROPERTY

Wird ausgelöst, wenn eine Funktionsoption bei der Ausführung keinen gültigen Wert für eine ihrer zurückgegebenen Objekteigenschaften liefert.

ERR_INVALID_RETURN_PROPERTY_VALUE

Wird ausgelöst, wenn eine Funktionsoption bei der Ausführung keinen erwarteten Werttyp für eine ihrer zurückgegebenen Objekteigenschaften liefert.

ERR_INVALID_RETURN_VALUE

Wird ausgelöst, wenn eine Funktionsoption bei der Ausführung keinen erwarteten Werttyp zurückgibt, z. B. wenn eine Funktion erwartet wird, ein Promise zurückzugeben.

ERR_INVALID_STATE

Hinzugefügt in: v15.0.0

Gibt an, dass ein Vorgang aufgrund eines ungültigen Zustands nicht abgeschlossen werden kann. Beispielsweise wurde ein Objekt möglicherweise bereits zerstört oder führt möglicherweise einen anderen Vorgang aus.

ERR_INVALID_SYNC_FORK_INPUT

Ein Buffer, TypedArray, DataView oder string wurde als stdio-Eingabe für ein asynchrones Fork bereitgestellt. Weitere Informationen finden Sie in der Dokumentation zum Modul child_process.

ERR_INVALID_THIS

Eine Node.js-API-Funktion wurde mit einem inkompatiblen this-Wert aufgerufen.

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

const buf = Buffer.alloc(1)
urlSearchParams.has.call(buf, 'foo')
// Wirft einen TypeError mit dem Code 'ERR_INVALID_THIS'

ERR_INVALID_TUPLE

Ein Element im iterable, das dem WHATWG URLSearchParams-Konstruktor bereitgestellt wurde, stellte kein [name, value]-Tupel dar – d. h., wenn ein Element nicht iterierbar ist oder nicht aus genau zwei Elementen besteht.

ERR_INVALID_TYPESCRIPT_SYNTAX

Hinzugefügt in: v23.0.0

Die bereitgestellte TypeScript-Syntax ist ungültig oder wird nicht unterstützt. Dies kann vorkommen, wenn TypeScript-Syntax verwendet wird, die eine Transformation mit Type-Stripping erfordert.

ERR_INVALID_URI

Es wurde ein ungültiger URI übergeben.

ERR_INVALID_URL

Es wurde eine ungültige URL an den WHATWG URL-Konstruktor oder den veralteten url.parse() zur Analyse übergeben. Das ausgeworfene Fehlerobjekt besitzt typischerweise eine zusätzliche Eigenschaft 'input', die die URL enthält, deren Analyse fehlgeschlagen ist.

ERR_INVALID_URL_SCHEME

Es wurde versucht, eine URL mit einem inkompatiblen Schema (Protokoll) für einen bestimmten Zweck zu verwenden. Sie wird nur in der WHATWG URL API-Unterstützung im fs-Modul verwendet (das nur URLs mit dem Schema 'file' akzeptiert), kann aber zukünftig auch in anderen Node.js-APIs verwendet werden.

ERR_IPC_CHANNEL_CLOSED

Es wurde versucht, einen bereits geschlossenen IPC-Kommunikationskanal zu verwenden.

ERR_IPC_DISCONNECTED

Es wurde versucht, einen bereits getrennten IPC-Kommunikationskanal zu trennen. Weitere Informationen finden Sie in der Dokumentation zum Modul child_process.

ERR_IPC_ONE_PIPE

Es wurde versucht, einen untergeordneten Node.js-Prozess mit mehr als einem IPC-Kommunikationskanal zu erstellen. Weitere Informationen finden Sie in der Dokumentation zum Modul child_process.

ERR_IPC_SYNC_FORK

Es wurde versucht, einen IPC-Kommunikationskanal mit einem synchron geforkten Node.js-Prozess zu öffnen. Weitere Informationen finden Sie in der Dokumentation zum Modul child_process.

ERR_IP_BLOCKED

IP wird von net.BlockList blockiert.

ERR_LOADER_CHAIN_INCOMPLETE

Hinzugefügt in: v18.6.0, v16.17.0

Ein ESM-Loader-Hook wurde zurückgegeben, ohne next() aufzurufen und ohne einen Kurzschluss explizit zu signalisieren.

ERR_LOAD_SQLITE_EXTENSION

Hinzugefügt in: v23.5.0

Ein Fehler ist beim Laden einer SQLite-Erweiterung aufgetreten.

ERR_MEMORY_ALLOCATION_FAILED

Es wurde versucht, Speicher (normalerweise in der C++-Schicht) zuzuweisen, dies ist jedoch fehlgeschlagen.

ERR_MESSAGE_TARGET_CONTEXT_UNAVAILABLE

Hinzugefügt in: v14.5.0, v12.19.0

Eine an einen MessagePort gesendete Nachricht konnte im Ziel-vm-Context nicht deserialisiert werden. Nicht alle Node.js-Objekte können derzeit in jedem Kontext erfolgreich instanziiert werden, und der Versuch, sie mit postMessage() zu übertragen, kann in diesem Fall auf der empfangenden Seite fehlschlagen.

ERR_METHOD_NOT_IMPLEMENTED

Eine Methode wird benötigt, ist aber nicht implementiert.

ERR_MISSING_ARGS

Ein benötigtes Argument einer Node.js-API wurde nicht übergeben. Dies wird nur für die strikte Einhaltung der API-Spezifikation verwendet (die in einigen Fällen func(undefined) akzeptieren kann, aber nicht func()). In den meisten nativen Node.js-APIs werden func(undefined) und func() identisch behandelt, und der Fehlercode ERR_INVALID_ARG_TYPE kann stattdessen verwendet werden.

ERR_MISSING_OPTION

Für APIs, die Options-Objekte akzeptieren, können einige Optionen obligatorisch sein. Dieser Code wird ausgegeben, wenn eine benötigte Option fehlt.

ERR_MISSING_PASSPHRASE

Es wurde versucht, einen verschlüsselten Schlüssel zu lesen, ohne eine Passphrase anzugeben.

ERR_MISSING_PLATFORM_FOR_WORKER

Die von dieser Node.js-Instanz verwendete V8-Plattform unterstützt nicht das Erstellen von Workers. Dies wird durch fehlende Embedder-Unterstützung für Workers verursacht. Insbesondere tritt dieser Fehler bei Standard-Builds von Node.js nicht auf.

ERR_MODULE_NOT_FOUND

Eine Moduldatei konnte vom ECMAScript-Modul-Loader während eines import-Vorgangs oder beim Laden des Programmeintrittspunkts nicht aufgelöst werden.

ERR_MULTIPLE_CALLBACK

Ein Callback wurde mehr als einmal aufgerufen.

Ein Callback sollte fast immer nur einmal aufgerufen werden, da die Anfrage entweder erfüllt oder abgelehnt werden kann, aber nicht beides gleichzeitig. Letzteres wäre durch mehrfaches Aufrufen eines Callbacks möglich.

ERR_NAPI_CONS_FUNCTION

Bei der Verwendung von Node-API war ein übergebener Konstruktor keine Funktion.

ERR_NAPI_INVALID_DATAVIEW_ARGS

Beim Aufruf von napi_create_dataview() lag ein gegebener offset außerhalb der Grenzen des Dataviews oder offset + length war größer als die Länge des gegebenen buffer.

ERR_NAPI_INVALID_TYPEDARRAY_ALIGNMENT

Beim Aufruf von napi_create_typedarray() war der angegebene offset kein Vielfaches der Elementgröße.

ERR_NAPI_INVALID_TYPEDARRAY_LENGTH

Beim Aufruf von napi_create_typedarray() war (length * size_of_element) + byte_offset größer als die Länge des gegebenen buffer.

ERR_NAPI_TSFN_CALL_JS

Ein Fehler ist beim Aufruf des JavaScript-Teils der threadsicheren Funktion aufgetreten.

ERR_NAPI_TSFN_GET_UNDEFINED

Ein Fehler ist beim Versuch aufgerufen worden, den JavaScript undefined-Wert abzurufen.

ERR_NON_CONTEXT_AWARE_DISABLED

Ein nicht kontextabhängiges natives Addon wurde in einem Prozess geladen, der diese nicht zulässt.

ERR_NOT_BUILDING_SNAPSHOT

Es wurde versucht, Operationen zu verwenden, die nur beim Erstellen eines V8-Start-Snapshots verwendet werden können, obwohl Node.js keinen erstellt.

ERR_NOT_IN_SINGLE_EXECUTABLE_APPLICATION

Hinzugefügt in: v21.7.0, v20.12.0

Der Vorgang kann nicht ausgeführt werden, wenn er sich nicht in einer Single-Executable-Anwendung befindet.

ERR_NOT_SUPPORTED_IN_SNAPSHOT

Es wurde versucht, Operationen durchzuführen, die beim Erstellen eines Start-Snapshots nicht unterstützt werden.

ERR_NO_CRYPTO

Es wurde versucht, Krypto-Funktionen zu verwenden, während Node.js nicht mit OpenSSL-Krypto-Unterstützung kompiliert wurde.

ERR_NO_ICU

Es wurde versucht, Funktionen zu verwenden, die ICU benötigen, aber Node.js wurde nicht mit ICU-Unterstützung kompiliert.

ERR_NO_TYPESCRIPT

Hinzugefügt in: v23.0.0

Es wurde versucht, Funktionen zu verwenden, die native TypeScript-Unterstützung benötigen, aber Node.js wurde nicht mit TypeScript-Unterstützung kompiliert.

ERR_OPERATION_FAILED

Hinzugefügt in: v15.0.0

Ein Vorgang ist fehlgeschlagen. Dies wird normalerweise verwendet, um das allgemeine Fehlschlagen einer asynchronen Operation zu signalisieren.

ERR_OUT_OF_RANGE

Ein gegebener Wert liegt außerhalb des akzeptierten Bereichs.

ERR_PACKAGE_IMPORT_NOT_DEFINED

Das Feld "imports" in package.json [/api/packages#imports] definiert keine Zuordnung für den angegebenen internen Package-Spezifizierer.

ERR_PACKAGE_PATH_NOT_EXPORTED

Das Feld "exports" in package.json [/api/packages#exports] exportiert nicht den angeforderten Unterpfad. Da Exporte gekapselt sind, können private interne Module, die nicht exportiert werden, nicht über die Package-Auflösung importiert werden, es sei denn, es wird eine absolute URL verwendet.

ERR_PARSE_ARGS_INVALID_OPTION_VALUE

Hinzugefügt in: v18.3.0, v16.17.0

Wenn strict auf true gesetzt ist, wird von util.parseArgs() geworfen, wenn ein Wert vom Typ <boolean> für eine Option vom Typ <string> angegeben wird, oder wenn ein Wert vom Typ <string> für eine Option vom Typ <boolean> angegeben wird.

ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL

Hinzugefügt in: v18.3.0, v16.17.0

Wird von util.parseArgs() geworfen, wenn ein positionales Argument angegeben wird und allowPositionals auf false gesetzt ist.

ERR_PARSE_ARGS_UNKNOWN_OPTION

Hinzugefügt in: v18.3.0, v16.17.0

Wenn strict auf true gesetzt ist, wird von util.parseArgs() geworfen, wenn ein Argument nicht in options konfiguriert ist.

ERR_PERFORMANCE_INVALID_TIMESTAMP

Es wurde ein ungültiger Zeitstempelwert für eine Performance-Markierung oder -messung bereitgestellt.

ERR_PERFORMANCE_MEASURE_INVALID_OPTIONS

Es wurden ungültige Optionen für eine Performance-Messung bereitgestellt.

ERR_PROTO_ACCESS

Der Zugriff auf Object.prototype.__proto__ wurde mit --disable-proto=throw verboten. Object.getPrototypeOf und Object.setPrototypeOf sollten verwendet werden, um den Prototyp eines Objekts zu erhalten und zu setzen.

ERR_QUIC_APPLICATION_ERROR

Hinzugefügt in: v23.4.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Ein QUIC-Anwendungsfehler ist aufgetreten.

ERR_QUIC_CONNECTION_FAILED

Hinzugefügt in: v23.0.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Das Herstellen einer QUIC-Verbindung ist fehlgeschlagen.

ERR_QUIC_ENDPOINT_CLOSED

Hinzugefügt in: v23.0.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Ein QUIC-Endpunkt wurde mit einem Fehler geschlossen.

ERR_QUIC_OPEN_STREAM_FAILED

Hinzugefügt in: v23.0.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Das Öffnen eines QUIC-Streams ist fehlgeschlagen.

ERR_QUIC_TRANSPORT_ERROR

Hinzugefügt in: v23.4.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Ein QUIC-Transportfehler ist aufgetreten.

ERR_QUIC_VERSION_NEGOTIATION_ERROR

Hinzugefügt in: v23.4.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Eine QUIC-Sitzung ist fehlgeschlagen, da eine Versionsverhandlung erforderlich ist.

ERR_REQUIRE_ASYNC_MODULE

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Beim Versuch, ein ES-Modul mit require() zu laden, stellt sich heraus, dass das Modul asynchron ist. Das heißt, es enthält ein Top-Level-await.

Um zu sehen, wo sich das Top-Level-await befindet, verwenden Sie --experimental-print-required-tla (dies führt die Module aus, bevor nach Top-Level-await gesucht wird).

ERR_REQUIRE_CYCLE_MODULE

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Beim Versuch, ein ES-Modul mit require() zu laden, ist eine CommonJS-zu-ESM- oder ESM-zu-CommonJS-Verbindung an einem unmittelbaren Kreislauf beteiligt. Dies ist nicht zulässig, da ES-Module nicht ausgewertet werden können, während sie bereits ausgewertet werden.

Um den Kreislauf zu vermeiden, sollte der require()-Aufruf, der an einem Kreislauf beteiligt ist, nicht auf oberster Ebene eines ES-Moduls (über createRequire()) oder eines CommonJS-Moduls erfolgen und sollte verzögert in einer inneren Funktion erfolgen.

ERR_REQUIRE_ESM

[Verlauf]

VersionÄnderungen
v23.0.0require() unterstützt jetzt standardmäßig das Laden synchroner ES-Module.

[Stabil: 0 - Veraltet]

Stabil: 0 Stabilität: 0 - Veraltet

Es wurde versucht, ein ES-Modul mit require() zu laden.

Dieser Fehler ist seit der Unterstützung von require() zum Laden synchroner ES-Module veraltet. Wenn require() auf ein ES-Modul trifft, das Top-Level-await enthält, wird stattdessen ERR_REQUIRE_ASYNC_MODULE ausgegeben.

ERR_SCRIPT_EXECUTION_INTERRUPTED

Die Skriptausführung wurde durch SIGINT unterbrochen (z. B. wurde + gedrückt).

ERR_SCRIPT_EXECUTION_TIMEOUT

Die Skriptausführung ist zeitlich abgelaufen, möglicherweise aufgrund von Fehlern im ausgeführten Skript.

ERR_SERVER_ALREADY_LISTEN

Die Methode server.listen() wurde aufgerufen, während ein net.Server bereits lauschte. Dies gilt für alle Instanzen von net.Server, einschließlich HTTP-, HTTPS- und HTTP/2-Server-Instanzen.

ERR_SERVER_NOT_RUNNING

Die Methode server.close() wurde aufgerufen, während ein net.Server nicht lief. Dies gilt für alle Instanzen von net.Server, einschließlich HTTP-, HTTPS- und HTTP/2-Server-Instanzen.

ERR_SINGLE_EXECUTABLE_APPLICATION_ASSET_NOT_FOUND

Hinzugefügt in: v21.7.0, v20.12.0

Ein Schlüssel wurde an APIs für Single-Executable-Anwendungen übergeben, um einen Asset zu identifizieren, aber es konnte keine Übereinstimmung gefunden werden.

ERR_SOCKET_ALREADY_BOUND

Es wurde versucht, einen Socket zu binden, der bereits gebunden ist.

ERR_SOCKET_BAD_BUFFER_SIZE

Eine ungültige (negative) Größe wurde für die Optionen recvBufferSize oder sendBufferSize in dgram.createSocket() übergeben.

ERR_SOCKET_BAD_PORT

Eine API-Funktion, die einen Port >= 0 und < 65536 erwartet, hat einen ungültigen Wert erhalten.

ERR_SOCKET_BAD_TYPE

Eine API-Funktion, die einen Socket-Typ (udp4 oder udp6) erwartet, hat einen ungültigen Wert erhalten.

ERR_SOCKET_BUFFER_SIZE

Bei der Verwendung von dgram.createSocket() konnte die Größe des empfangenen oder gesendeten Buffer nicht ermittelt werden.

ERR_SOCKET_CLOSED

Es wurde versucht, mit einem bereits geschlossenen Socket zu arbeiten.

ERR_SOCKET_CLOSED_BEFORE_CONNECTION

Beim Aufruf von net.Socket.write() an einem Verbindungs-Socket und der Socket wurde geschlossen, bevor die Verbindung hergestellt wurde.

ERR_SOCKET_CONNECTION_TIMEOUT

Der Socket konnte innerhalb des zulässigen Timeouts keine Verbindung zu einer von DNS zurückgegebenen Adresse herstellen, wenn der Algorithmus zur automatischen Familienauswahl verwendet wurde.

ERR_SOCKET_DGRAM_IS_CONNECTED

Ein dgram.connect()-Aufruf wurde an einem bereits verbundenen Socket durchgeführt.

ERR_SOCKET_DGRAM_NOT_CONNECTED

Ein dgram.disconnect()- oder dgram.remoteAddress()-Aufruf wurde an einem nicht verbundenen Socket durchgeführt.

ERR_SOCKET_DGRAM_NOT_RUNNING

Ein Aufruf wurde getätigt und das UDP-Subsystem lief nicht.

ERR_SOURCE_MAP_CORRUPT

Die Source Map konnte nicht analysiert werden, da sie nicht existiert oder beschädigt ist.

ERR_SOURCE_MAP_MISSING_SOURCE

Eine von einer Source Map importierte Datei wurde nicht gefunden.

ERR_SQLITE_ERROR

Hinzugefügt in: v22.5.0

Ein Fehler wurde von SQLite zurückgegeben.

ERR_SRI_PARSE

Eine Zeichenkette wurde für eine Subresource Integrity-Prüfung bereitgestellt, konnte aber nicht analysiert werden. Überprüfen Sie das Format der Integrity-Attribute anhand der Subresource Integrity-Spezifikation.

ERR_STREAM_ALREADY_FINISHED

Es wurde eine Stream-Methode aufgerufen, die nicht abgeschlossen werden kann, da der Stream beendet wurde.

ERR_STREAM_CANNOT_PIPE

Es wurde versucht, stream.pipe() auf einem Writable-Stream aufzurufen.

ERR_STREAM_DESTROYED

Es wurde eine Stream-Methode aufgerufen, die nicht abgeschlossen werden kann, da der Stream mit stream.destroy() zerstört wurde.

ERR_STREAM_NULL_VALUES

Es wurde versucht, stream.write() mit einem null-Chunk aufzurufen.

ERR_STREAM_PREMATURE_CLOSE

Ein Fehler, der von stream.finished() und stream.pipeline() zurückgegeben wird, wenn ein Stream oder eine Pipeline nicht ordnungsgemäß ohne expliziten Fehler endet.

ERR_STREAM_PUSH_AFTER_EOF

Es wurde versucht, stream.push() aufzurufen, nachdem ein null (EOF) in den Stream gepusht wurde.

ERR_STREAM_UNABLE_TO_PIPE

Es wurde versucht, in einer Pipeline an einen geschlossenen oder zerstörten Stream zu pipen.

ERR_STREAM_UNSHIFT_AFTER_END_EVENT

Es wurde versucht, stream.unshift() aufzurufen, nachdem das Ereignis 'end' ausgelöst wurde.

ERR_STREAM_WRAP

Verhindert einen Abbruch, wenn ein String-Decoder auf dem Socket gesetzt wurde oder wenn sich der Decoder im objectMode befindet.

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

instance.setEncoding('utf8')

ERR_STREAM_WRITE_AFTER_END

Ein Versuch, stream.write() aufzurufen, nachdem stream.end() aufgerufen wurde.

ERR_STRING_TOO_LONG

Es wurde versucht, einen String zu erstellen, der länger als die maximal zulässige Länge ist.

ERR_SYNTHETIC

Ein künstliches Fehlerobjekt, das verwendet wird, um den Aufrufstack für Diagnoseberichte zu erfassen.

ERR_SYSTEM_ERROR

Innerhalb des Node.js-Prozesses ist ein nicht spezifizierter oder unspezifischer Systemfehler aufgetreten. Das Fehlerobjekt enthält eine err.info-Objekteigenschaft mit zusätzlichen Details.

ERR_TAP_LEXER_ERROR

Ein Fehler, der einen fehlerhaften Lexer-Zustand darstellt.

ERR_TAP_PARSER_ERROR

Ein Fehler, der einen fehlerhaften Parser-Zustand darstellt. Zusätzliche Informationen über das Token, das den Fehler verursacht hat, sind über die Eigenschaft cause verfügbar.

ERR_TAP_VALIDATION_ERROR

Dieser Fehler stellt eine fehlgeschlagene TAP-Validierung dar.

ERR_TEST_FAILURE

Dieser Fehler stellt einen fehlgeschlagenen Test dar. Zusätzliche Informationen über den Fehler sind über die Eigenschaft cause verfügbar. Die Eigenschaft failureType gibt an, was der Test während des Fehlers tat.

ERR_TLS_ALPN_CALLBACK_INVALID_RESULT

Dieser Fehler wird ausgelöst, wenn ein ALPNCallback einen Wert zurückgibt, der nicht in der Liste der vom Client angebotenen ALPN-Protokolle enthalten ist.

ERR_TLS_ALPN_CALLBACK_WITH_PROTOCOLS

Dieser Fehler wird beim Erstellen eines TLSServer ausgelöst, wenn die TLS-Optionen sowohl ALPNProtocols als auch ALPNCallback enthalten. Diese Optionen schließen sich gegenseitig aus.

ERR_TLS_CERT_ALTNAME_FORMAT

Dieser Fehler wird von checkServerIdentity ausgelöst, wenn eine benutzerdefinierte subjectaltname-Eigenschaft gegen Kodierungsregeln verstößt. Von Node.js selbst erzeugte Zertifikatsobjekte entsprechen immer den Kodierungsregeln und verursachen diesen Fehler niemals.

ERR_TLS_CERT_ALTNAME_INVALID

Während der Verwendung von TLS stimmte der Hostname/die IP des Peers mit keinem der subjectAltNames in seinem Zertifikat überein.

ERR_TLS_DH_PARAM_SIZE

Während der Verwendung von TLS ist der für das Diffie-Hellman-Schlüsselaustauschprotokoll (DH) angebotene Parameter zu klein. Standardmäßig muss die Schlüssellänge größer oder gleich 1024 Bit sein, um Schwachstellen zu vermeiden, obwohl es dringend empfohlen wird, 2048 Bit oder mehr für eine höhere Sicherheit zu verwenden.

ERR_TLS_HANDSHAKE_TIMEOUT

Ein TLS/SSL-Handshake ist zeitlich abgelaufen. In diesem Fall muss der Server die Verbindung ebenfalls abbrechen.

ERR_TLS_INVALID_CONTEXT

Hinzugefügt in: v13.3.0

Der Kontext muss ein SecureContext sein.

ERR_TLS_INVALID_PROTOCOL_METHOD

Die angegebene secureProtocol-Methode ist ungültig. Sie ist entweder unbekannt oder deaktiviert, weil sie unsicher ist.

ERR_TLS_INVALID_PROTOCOL_VERSION

Gültige TLS-Protokollversionen sind 'TLSv1', 'TLSv1.1' oder 'TLSv1.2'.

ERR_TLS_INVALID_STATE

Hinzugefügt in: v13.10.0, v12.17.0

Die TLS-Socket muss verbunden und sicher hergestellt sein. Stellen Sie sicher, dass das 'secure'-Ereignis emittiert wird, bevor Sie fortfahren.

ERR_TLS_PROTOCOL_VERSION_CONFLICT

Der Versuch, eine TLS-Protokoll minVersion oder maxVersion zu setzen, steht im Konflikt mit dem Versuch, secureProtocol explizit zu setzen. Verwenden Sie den einen oder den anderen Mechanismus.

ERR_TLS_PSK_SET_IDENTITY_HINT_FAILED

Das Setzen des PSK-Identitätshinweises ist fehlgeschlagen. Der Hinweis ist möglicherweise zu lang.

ERR_TLS_RENEGOTIATION_DISABLED

Es wurde versucht, TLS auf einer Socket-Instanz mit deaktivierter Neuverhandlung neu zu verhandeln.

ERR_TLS_REQUIRED_SERVER_NAME

Bei Verwendung von TLS wurde die Methode server.addContext() aufgerufen, ohne einen Hostnamen im ersten Parameter anzugeben.

ERR_TLS_SESSION_ATTACK

Es wurde eine übermäßige Anzahl von TLS-Neuverhandlungen erkannt, was ein potenzieller Vektor für Denial-of-Service-Angriffe darstellt.

ERR_TLS_SNI_FROM_SERVER

Es wurde versucht, eine Server Name Indication von einer TLS-Server-Socket auszustellen, was nur von einem Client gültig ist.

ERR_TRACE_EVENTS_CATEGORY_REQUIRED

Die Methode trace_events.createTracing() benötigt mindestens eine Trace-Ereigniskategorie.

ERR_TRACE_EVENTS_UNAVAILABLE

Das Modul node:trace_events konnte nicht geladen werden, da Node.js mit dem Flag --without-v8-platform kompiliert wurde.

ERR_TRANSFORM_ALREADY_TRANSFORMING

Ein Transform-Stream wurde beendet, während er noch transformiert wurde.

ERR_TRANSFORM_WITH_LENGTH_0

Ein Transform-Stream wurde beendet, während sich noch Daten im Schreibpuffer befanden.

ERR_TTY_INIT_FAILED

Die Initialisierung eines TTY ist aufgrund eines Systemfehlers fehlgeschlagen.

ERR_UNAVAILABLE_DURING_EXIT

Die Funktion wurde innerhalb eines process.on('exit')-Handlers aufgerufen, der nicht innerhalb eines process.on('exit')-Handlers aufgerufen werden sollte.

ERR_UNCAUGHT_EXCEPTION_CAPTURE_ALREADY_SET

process.setUncaughtExceptionCaptureCallback() wurde zweimal aufgerufen, ohne den Callback zuvor auf null zurückzusetzen.

Dieser Fehler soll verhindern, dass versehentlich ein von einem anderen Modul registrierter Callback überschrieben wird.

ERR_UNESCAPED_CHARACTERS

Es wurde eine Zeichenkette mit nicht maskierten Zeichen empfangen.

ERR_UNHANDLED_ERROR

Es ist ein nicht behandelter Fehler aufgetreten (z. B. wenn ein 'error'-Ereignis von einem EventEmitter emittiert wird, aber kein 'error'-Handler registriert ist).

ERR_UNKNOWN_BUILTIN_MODULE

Wird verwendet, um eine bestimmte Art von internem Node.js-Fehler zu identifizieren, der normalerweise nicht durch Benutzercode ausgelöst werden sollte. Instanzen dieses Fehlers weisen auf einen internen Fehler in der Node.js-Binärdatei selbst hin.

ERR_UNKNOWN_CREDENTIAL

Es wurde eine Unix-Gruppen- oder Benutzerkennung übergeben, die nicht existiert.

ERR_UNKNOWN_ENCODING

Eine ungültige oder unbekannte Codierungsoption wurde an eine API übergeben.

ERR_UNKNOWN_FILE_EXTENSION

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Es wurde versucht, ein Modul mit einer unbekannten oder nicht unterstützten Dateierweiterung zu laden.

ERR_UNKNOWN_MODULE_FORMAT

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Es wurde versucht, ein Modul mit einem unbekannten oder nicht unterstützten Format zu laden.

ERR_UNKNOWN_SIGNAL

Ein ungültiges oder unbekanntes Prozesssignal wurde an eine API übergeben, die ein gültiges Signal erwartet (z. B. subprocess.kill()).

ERR_UNSUPPORTED_DIR_IMPORT

Das Importieren einer Verzeichnis-URL wird nicht unterstützt. Verwenden Sie stattdessen Selbstreferenzierung eines Pakets über seinen Namen und definieren Sie einen benutzerdefinierten Subpfad im Feld "exports" der Datei package.json.

js
import './' // nicht unterstützt
import './index.js' // unterstützt
import 'package-name' // unterstützt

ERR_UNSUPPORTED_ESM_URL_SCHEME

import mit anderen URL-Schemata als file und data wird nicht unterstützt.

ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING

Hinzugefügt in: v22.6.0

Typprüfung wird für Dateien, die von einem node_modules-Verzeichnis abstammen, nicht unterstützt.

ERR_UNSUPPORTED_RESOLVE_REQUEST

Es wurde versucht, einen ungültigen Modul-Referrer aufzulösen. Dies kann passieren, wenn import oder import.meta.resolve() mit folgendem aufgerufen wird:

  • einem Bare Specifier, der kein eingebautes Modul aus einem Modul ist, dessen URL-Schema nicht file ist.
  • einer relativen URL aus einem Modul, dessen URL-Schema kein speziales Schema ist.
js
try {
  // Versuch, das Paket 'bare-specifier' aus einem `data:`-URL-Modul zu importieren:
  await import('data:text/javascript,import "bare-specifier"')
} catch (e) {
  console.log(e.code) // ERR_UNSUPPORTED_RESOLVE_REQUEST
}

ERR_USE_AFTER_CLOSE

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1 - Experimentell

Es wurde versucht, etwas zu verwenden, das bereits geschlossen wurde.

ERR_VALID_PERFORMANCE_ENTRY_TYPE

Bei Verwendung der Performance Timing API (perf_hooks) werden keine gültigen Performance-Eintragsarten gefunden.

ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING

Ein dynamischer Import-Callback wurde nicht angegeben.

ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING_FLAG

Ein dynamischer Import-Callback wurde ohne --experimental-vm-modules aufgerufen.

ERR_VM_MODULE_ALREADY_LINKED

Das zu verknüpfende Modul ist aus einem der folgenden Gründe nicht verknüpfbar:

  • Es wurde bereits verknüpft (linkingStatus ist 'linked')
  • Es wird gerade verknüpft (linkingStatus ist 'linking')
  • Die Verknüpfung dieses Moduls ist fehlgeschlagen (linkingStatus ist 'errored')

ERR_VM_MODULE_CACHED_DATA_REJECTED

Die an einen Modulkonstruktor übergebene Option cachedData ist ungültig.

ERR_VM_MODULE_CANNOT_CREATE_CACHED_DATA

Für Module, die bereits ausgewertet wurden, können keine zwischengespeicherten Daten erstellt werden.

ERR_VM_MODULE_DIFFERENT_CONTEXT

Das vom Linker-Funktionsaufruf zurückgegebene Modul stammt aus einem anderen Kontext als das übergeordnete Modul. Verknüpfte Module müssen denselben Kontext gemeinsam nutzen.

Das Modul konnte aufgrund eines Fehlers nicht verknüpft werden.

ERR_VM_MODULE_NOT_MODULE

Der erfüllte Wert eines Linking-Promise ist kein vm.Module-Objekt.

ERR_VM_MODULE_STATUS

Der aktuelle Status des Moduls erlaubt diesen Vorgang nicht. Die genaue Bedeutung des Fehlers hängt von der jeweiligen Funktion ab.

ERR_WASI_ALREADY_STARTED

Die WASI-Instanz wurde bereits gestartet.

ERR_WASI_NOT_STARTED

Die WASI-Instanz wurde noch nicht gestartet.

ERR_WEBASSEMBLY_RESPONSE

Hinzugefügt in: v18.1.0

Die Response, die an WebAssembly.compileStreaming oder an WebAssembly.instantiateStreaming übergeben wurde, ist keine gültige WebAssembly-Antwort.

ERR_WORKER_INIT_FAILED

Die Worker-Initialisierung ist fehlgeschlagen.

ERR_WORKER_INVALID_EXEC_ARGV

Die an den Worker-Konstruktor übergebene Option execArgv enthält ungültige Flags.

ERR_WORKER_MESSAGING_ERRORED

Hinzugefügt in: v22.5.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1.1 - Aktive Entwicklung

Der Zielthread hat einen Fehler bei der Verarbeitung einer über postMessageToThread() gesendeten Nachricht ausgelöst.

ERR_WORKER_MESSAGING_FAILED

Hinzugefügt in: v22.5.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1.1 - Aktive Entwicklung

Der in postMessageToThread() angeforderte Thread ist ungültig oder besitzt keinen workerMessage-Listener.

ERR_WORKER_MESSAGING_SAME_THREAD

Hinzugefügt in: v22.5.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1.1 - Aktive Entwicklung

Die in postMessageToThread() angeforderte Thread-ID ist die aktuelle Thread-ID.

ERR_WORKER_MESSAGING_TIMEOUT

Hinzugefügt in: v22.5.0

[Stabil: 1 - Experimentell]

Stabil: 1 Stabilität: 1.1 - Aktive Entwicklung

Das Senden einer Nachricht über postMessageToThread() ist zeitlich begrenzt abgelaufen.

ERR_WORKER_NOT_RUNNING

Ein Vorgang ist fehlgeschlagen, da die Worker-Instanz derzeit nicht ausgeführt wird.

ERR_WORKER_OUT_OF_MEMORY

Die Worker-Instanz wurde beendet, weil der Speichergrenzwert erreicht wurde.

ERR_WORKER_PATH

Der Pfad für das Hauptskript eines Workers ist weder ein absoluter Pfad noch ein relativer Pfad, der mit ./ oder ../ beginnt.

ERR_WORKER_UNSERIALIZABLE_ERROR

Alle Versuche, eine nicht abgefangene Ausnahme aus einem Worker-Thread zu serialisieren, sind fehlgeschlagen.

ERR_WORKER_UNSUPPORTED_OPERATION

Die angeforderte Funktionalität wird in Worker-Threads nicht unterstützt.

ERR_ZLIB_INITIALIZATION_FAILED

Die Erstellung eines zlib-Objekts ist aufgrund einer falschen Konfiguration fehlgeschlagen.

HPE_CHUNK_EXTENSIONS_OVERFLOW

Hinzugefügt in: v21.6.2, v20.11.1, v18.19.1

Es wurden zu viele Daten für Chunk-Erweiterungen empfangen. Um sich vor böswilligen oder falsch konfigurierten Clients zu schützen, wird bei Empfang von mehr als 16 KiB Daten ein Error mit diesem Code ausgegeben.

HPE_HEADER_OVERFLOW

[Historie]

VersionÄnderungen
v11.4.0, v10.15.0Maximale Header-Größe in http_parser auf 8 KiB gesetzt.

Es wurden zu viele HTTP-Header-Daten empfangen. Um sich vor böswilligen oder falsch konfigurierten Clients zu schützen, wird die HTTP-Analyse abgebrochen, ohne dass ein Request- oder Response-Objekt erstellt wird, wenn mehr als maxHeaderSize an HTTP-Header-Daten empfangen werden. Ein Error mit diesem Code wird ausgegeben.

HPE_UNEXPECTED_CONTENT_LENGTH

Der Server sendet sowohl einen Content-Length-Header als auch Transfer-Encoding: chunked.

Transfer-Encoding: chunked ermöglicht es dem Server, eine persistente HTTP-Verbindung für dynamisch generierte Inhalte aufrechtzuerhalten. In diesem Fall kann der Content-Length-HTTP-Header nicht verwendet werden.

Verwenden Sie Content-Length oder Transfer-Encoding: chunked.

MODULE_NOT_FOUND

[Historie]

VersionÄnderungen
v12.0.0requireStack-Eigenschaft hinzugefügt.

Eine Moduldatei konnte vom CommonJS-Modul-Loader während eines require()-Vorgangs oder beim Laden des Programmeinstiegspunkts nicht aufgelöst werden.

Veraltete Node.js-Fehlercodes

[Stabil: 0 - Veraltet]

Stabil: 0 Stabilität: 0 - Veraltet. Diese Fehlercodes sind entweder inkonsistent oder wurden entfernt.

ERR_CANNOT_TRANSFER_OBJECT

Hinzugefügt in: v10.5.0

Entfernt in: v12.5.0

Der an postMessage() übergebene Wert enthielt ein Objekt, das nicht für die Übertragung unterstützt wird.

ERR_CPU_USAGE

Entfernt in: v15.0.0

Der native Aufruf von process.cpuUsage konnte nicht verarbeitet werden.

ERR_CRYPTO_HASH_DIGEST_NO_UTF16

Hinzugefügt in: v9.0.0

Entfernt in: v12.12.0

Die UTF-16-Kodierung wurde mit hash.digest() verwendet. Obwohl die hash.digest()-Methode die Übergabe eines encoding-Arguments erlaubt, wodurch die Methode eine Zeichenkette anstelle eines Buffer zurückgibt, wird die UTF-16-Kodierung (z. B. ucs oder utf16le) nicht unterstützt.

ERR_CRYPTO_SCRYPT_INVALID_PARAMETER

Entfernt in: v23.0.0

Eine inkompatible Kombination von Optionen wurde an crypto.scrypt() oder crypto.scryptSync() übergeben. Neuere Versionen von Node.js verwenden stattdessen den Fehlercode ERR_INCOMPATIBLE_OPTION_PAIR, der mit anderen APIs übereinstimmt.

Entfernt in: v23.0.0

Ein ungültiger Symlink-Typ wurde an die Methoden fs.symlink() oder fs.symlinkSync() übergeben.

ERR_HTTP2_FRAME_ERROR

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn beim Senden eines einzelnen Frames in der HTTP/2-Sitzung ein Fehler auftritt.

ERR_HTTP2_HEADERS_OBJECT

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn ein HTTP/2-Header-Objekt erwartet wird.

ERR_HTTP2_HEADER_REQUIRED

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn ein erforderlicher Header in einer HTTP/2-Nachricht fehlt.

ERR_HTTP2_INFO_HEADERS_AFTER_RESPOND

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

HTTP/2-Informationsheader dürfen nur vor dem Aufruf der Methode Http2Stream.prototype.respond() gesendet werden.

ERR_HTTP2_STREAM_CLOSED

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn eine Aktion auf einem HTTP/2-Stream ausgeführt wurde, der bereits geschlossen wurde.

ERR_HTTP_INVALID_CHAR

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn ein ungültiges Zeichen in einer HTTP-Antwortstatusmeldung (Begründungsphrase) gefunden wird.

ERR_IMPORT_ASSERTION_TYPE_FAILED

Hinzugefügt in: v17.1.0, v16.14.0

Entfernt in: v21.1.0

Eine Import-Assertion ist fehlgeschlagen, wodurch das Importieren des angegebenen Moduls verhindert wird.

ERR_IMPORT_ASSERTION_TYPE_MISSING

Hinzugefügt in: v17.1.0, v16.14.0

Entfernt in: v21.1.0

Eine Import-Assertion fehlt, wodurch das Importieren des angegebenen Moduls verhindert wird.

ERR_IMPORT_ASSERTION_TYPE_UNSUPPORTED

Hinzugefügt in: v17.1.0, v16.14.0

Entfernt in: v21.1.0

Ein Import-Attribut wird von dieser Node.js-Version nicht unterstützt.

ERR_INDEX_OUT_OF_RANGE

Hinzugefügt in: v10.0.0

Entfernt in: v11.0.0

Ein gegebener Index lag außerhalb des akzeptierten Bereichs (z. B. negative Offsets).

ERR_INVALID_OPT_VALUE

Hinzugefügt in: v8.0.0

Entfernt in: v15.0.0

Ein ungültiger oder unerwarteter Wert wurde in einem Options-Objekt übergeben.

ERR_INVALID_OPT_VALUE_ENCODING

Hinzugefügt in: v9.0.0

Entfernt in: v15.0.0

Eine ungültige oder unbekannte Datei-Codierung wurde übergeben.

ERR_INVALID_PERFORMANCE_MARK

Hinzugefügt in: v8.5.0

Entfernt in: v16.7.0

Bei der Verwendung der Performance Timing API (perf_hooks) ist eine Performance-Markierung ungültig.

ERR_INVALID_TRANSFER_OBJECT

[Verlauf]

VersionÄnderungen
v21.0.0Stattdessen wird eine DOMException ausgelöst.
v21.0.0Entfernt in: v21.0.0

Ein ungültiges Transferobjekt wurde an postMessage() übergeben.

ERR_MANIFEST_ASSERT_INTEGRITY

Entfernt in: v22.2.0

Es wurde versucht, eine Ressource zu laden, aber die Ressource entsprach nicht der durch das Richtlinenmanifest definierten Integrität. Weitere Informationen finden Sie in der Dokumentation zu Richtlinenmanifesten.

ERR_MANIFEST_DEPENDENCY_MISSING

Entfernt in: v22.2.0

Es wurde versucht, eine Ressource zu laden, aber die Ressource wurde nicht als Abhängigkeit von dem Ort aufgeführt, der versucht hat, sie zu laden. Weitere Informationen finden Sie in der Dokumentation zu Richtlinenmanifesten.

ERR_MANIFEST_INTEGRITY_MISMATCH

Entfernt in: v22.2.0

Es wurde versucht, ein Richtlinenmanifest zu laden, aber das Manifest enthielt mehrere Einträge für eine Ressource, die nicht übereinstimmten. Aktualisieren Sie die Manifesteinträge, damit sie übereinstimmen, um diesen Fehler zu beheben. Weitere Informationen finden Sie in der Dokumentation zu Richtlinenmanifesten.

ERR_MANIFEST_INVALID_RESOURCE_FIELD

Entfernt in: v22.2.0

Eine Richtlinenmanifest-Ressource hatte einen ungültigen Wert für eines ihrer Felder. Aktualisieren Sie den Manifesteintrag, damit er übereinstimmt, um diesen Fehler zu beheben. Weitere Informationen finden Sie in der Dokumentation zu Richtlinenmanifesten.

ERR_MANIFEST_INVALID_SPECIFIER

Entfernt in: v22.2.0

Eine Richtlinien-Manifest-Ressource enthielt einen ungültigen Wert für eine ihrer Abhängigkeitszuordnungen. Aktualisieren Sie den Manifesteintrag, um diesen Fehler zu beheben. Weitere Informationen finden Sie in der Dokumentation zu Richtlinien-Manifesten.

ERR_MANIFEST_PARSE_POLICY

Entfernt in: v22.2.0

Es wurde versucht, ein Richtlinien-Manifest zu laden, aber das Manifest konnte nicht analysiert werden. Weitere Informationen finden Sie in der Dokumentation zu Richtlinien-Manifesten.

ERR_MANIFEST_TDZ

Entfernt in: v22.2.0

Es wurde versucht, aus einem Richtlinien-Manifest zu lesen, aber die Manifestinitialisierung wurde noch nicht durchgeführt. Dies ist wahrscheinlich ein Fehler in Node.js.

ERR_MANIFEST_UNKNOWN_ONERROR

Entfernt in: v22.2.0

Ein Richtlinien-Manifest wurde geladen, enthielt aber einen unbekannten Wert für sein "onerror"-Verhalten. Weitere Informationen finden Sie in der Dokumentation zu Richtlinien-Manifesten.

ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST

Entfernt in: v15.0.0

Dieser Fehlercode wurde in Node.js v15.0.0 durch ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST ersetzt, da er nicht mehr zutreffend ist, da jetzt auch andere Arten von übertragbaren Objekten existieren.

ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST

[Verlauf]

VersionÄnderungen
v21.0.0Stattdessen wird eine DOMException ausgelöst.
v21.0.0Entfernt in: v21.0.0
v15.0.0Hinzugefügt in: v15.0.0

Ein Objekt, das explizit in der Argumentliste transferList aufgeführt werden muss, befindet sich in dem Objekt, das an einen postMessage()-Aufruf übergeben wird, wird aber nicht in der transferList für diesen Aufruf bereitgestellt. Normalerweise handelt es sich dabei um einen MessagePort.

In Node.js-Versionen vor v15.0.0 war der hier verwendete Fehlercode ERR_MISSING_MESSAGE_PORT_IN_TRANSFER_LIST. Die Menge der übertragbaren Objekttypen wurde jedoch erweitert, um mehr Typen als MessagePort abzudecken.

ERR_NAPI_CONS_PROTOTYPE_OBJECT

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird von der Node-API verwendet, wenn Constructor.prototype kein Objekt ist.

ERR_NAPI_TSFN_START_IDLE_LOOP

Hinzugefügt in: v10.6.0, v8.16.0

Entfernt in: v14.2.0, v12.17.0

Im Hauptthread werden Werte in einer Leerlaufschleife aus der Warteschlange entfernt, die der threadsicheren Funktion zugeordnet ist. Dieser Fehler zeigt an, dass beim Starten der Schleife ein Fehler aufgetreten ist.

ERR_NAPI_TSFN_STOP_IDLE_LOOP

Hinzugefügt in: v10.6.0, v8.16.0

Entfernt in: v14.2.0, v12.17.0

Sobald keine Elemente mehr in der Warteschlange vorhanden sind, muss die Leerlaufschleife angehalten werden. Dieser Fehler zeigt an, dass die Leerlaufschleife nicht angehalten werden konnte.

ERR_NO_LONGER_SUPPORTED

Eine Node.js-API wurde auf nicht unterstützte Weise aufgerufen, z. B. Buffer.write(string, encoding, offset[, length]).

ERR_OUTOFMEMORY

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird allgemein verwendet, um anzugeben, dass ein Vorgang einen Speichermangel verursacht hat.

ERR_PARSE_HISTORY_DATA

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Das Modul node:repl konnte keine Daten aus der REPL-Verlaufsdatei analysieren.

ERR_SOCKET_CANNOT_SEND

Hinzugefügt in: v9.0.0

Entfernt in: v14.0.0

Daten konnten nicht an einen Socket gesendet werden.

ERR_STDERR_CLOSE

[Verlauf]

VersionÄnderungen
v10.12.0Anstatt einen Fehler auszulösen, schließt process.stderr.end() jetzt nur noch die Stream-Seite, aber nicht die zugrunde liegende Ressource, wodurch dieser Fehler überflüssig wird.
v10.12.0Entfernt in: v10.12.0

Es wurde versucht, den Stream process.stderr zu schließen. Node.js erlaubt es standardmäßig nicht, dass stdout- oder stderr-Streams vom Benutzercode geschlossen werden.

ERR_STDOUT_CLOSE

[Verlauf]

VersionÄnderungen
v10.12.0Anstatt einen Fehler auszulösen, schließt process.stderr.end() jetzt nur noch die Stream-Seite, aber nicht die zugrunde liegende Ressource, wodurch dieser Fehler überflüssig wird.
v10.12.0Entfernt in: v10.12.0

Es wurde versucht, den Stream process.stdout zu schließen. Node.js erlaubt es standardmäßig nicht, dass stdout- oder stderr-Streams vom Benutzercode geschlossen werden.

ERR_STREAM_READ_NOT_IMPLEMENTED

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn versucht wird, einen lesbaren Stream zu verwenden, der readable._read() nicht implementiert hat.

ERR_TLS_RENEGOTIATION_FAILED

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn eine TLS-Renegotiierungsanforderung auf nicht spezifizierte Weise fehlgeschlagen ist.

ERR_TRANSFERRING_EXTERNALIZED_SHAREDARRAYBUFFER

Hinzugefügt in: v10.5.0

Entfernt in: v14.0.0

Während der Serialisierung wurde ein SharedArrayBuffer gefunden, dessen Speicher nicht von der JavaScript-Engine oder von Node.js verwaltet wird. Ein solcher SharedArrayBuffer kann nicht serialisiert werden.

Dies kann nur passieren, wenn native Addons SharedArrayBuffers im "externalisierten" Modus erstellen oder vorhandene SharedArrayBuffers in den externalisierten Modus versetzen.

ERR_UNKNOWN_STDIN_TYPE

Hinzugefügt in: v8.0.0

Entfernt in: v11.7.0

Es wurde versucht, einen Node.js-Prozess mit einem unbekannten stdin-Dateityp zu starten. Dieser Fehler deutet normalerweise auf einen Fehler in Node.js selbst hin, obwohl es möglich ist, dass Benutzercode ihn auslöst.

ERR_UNKNOWN_STREAM_TYPE

Hinzugefügt in: v8.0.0

Entfernt in: v11.7.0

Es wurde versucht, einen Node.js-Prozess mit einem unbekannten stdout- oder stderr-Dateityp zu starten. Dieser Fehler deutet normalerweise auf einen Fehler in Node.js selbst hin, obwohl es möglich ist, dass Benutzercode ihn auslöst.

ERR_V8BREAKITERATOR

Die V8 BreakIterator-API wurde verwendet, aber der vollständige ICU-Datensatz ist nicht installiert.

ERR_VALUE_OUT_OF_RANGE

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn ein gegebener Wert außerhalb des akzeptierten Bereichs liegt.

ERR_VM_MODULE_LINKING_ERRORED

Hinzugefügt in: v10.0.0

Entfernt in: v18.1.0, v16.17.0

Die Linkerfunktion hat ein Modul zurückgegeben, für das das Linking fehlgeschlagen ist.

ERR_VM_MODULE_NOT_LINKED

Das Modul muss erfolgreich verlinkt werden, bevor es instanziiert werden kann.

ERR_WORKER_UNSUPPORTED_EXTENSION

Hinzugefügt in: v11.0.0

Entfernt in: v16.9.0

Der für das Hauptskript eines Workers verwendete Dateiname hat eine unbekannte Dateiendung.

ERR_ZLIB_BINDING_CLOSED

Hinzugefügt in: v9.0.0

Entfernt in: v10.0.0

Wird verwendet, wenn versucht wird, ein zlib-Objekt zu verwenden, nachdem es bereits geschlossen wurde.

OpenSSL-Fehlercodes

Zeitliche Gültigkeitsfehler

CERT_NOT_YET_VALID

Das Zertifikat ist noch nicht gültig: Das notBefore-Datum liegt nach der aktuellen Zeit.

CERT_HAS_EXPIRED

Das Zertifikat ist abgelaufen: Das notAfter-Datum liegt vor der aktuellen Zeit.

CRL_NOT_YET_VALID

Die Zertifikatsperrliste (CRL) hat ein zukünftiges Ausstellungsdatum.

CRL_HAS_EXPIRED

Die Zertifikatsperrliste (CRL) ist abgelaufen.

CERT_REVOKED

Das Zertifikat wurde widerrufen; es befindet sich auf einer Zertifikatsperrliste (CRL).

UNABLE_TO_GET_ISSUER_CERT

Das Ausstellerzertifikat eines nachgeschlagenen Zertifikats konnte nicht gefunden werden. Dies bedeutet normalerweise, dass die Liste der vertrauenswürdigen Zertifikate unvollständig ist.

UNABLE_TO_GET_ISSUER_CERT_LOCALLY

Der Aussteller des Zertifikats ist unbekannt. Dies ist der Fall, wenn der Aussteller nicht in der Liste der vertrauenswürdigen Zertifikate enthalten ist.

DEPTH_ZERO_SELF_SIGNED_CERT

Das übergebene Zertifikat ist selbstsigniert und dasselbe Zertifikat kann nicht in der Liste der vertrauenswürdigen Zertifikate gefunden werden.

SELF_SIGNED_CERT_IN_CHAIN

Der Aussteller des Zertifikats ist unbekannt. Dies ist der Fall, wenn der Aussteller nicht in der Liste der vertrauenswürdigen Zertifikate enthalten ist.

CERT_CHAIN_TOO_LONG

Die Länge der Zertifikatkette ist größer als die maximale Tiefe.

UNABLE_TO_GET_CRL

Die vom Zertifikat referenzierte CRL konnte nicht gefunden werden.

UNABLE_TO_VERIFY_LEAF_SIGNATURE

Keine Signaturen konnten verifiziert werden, da die Kette nur ein Zertifikat enthält und dieses nicht selbstsigniert ist.

CERT_UNTRUSTED

Die Root-Zertifizierungsstelle (CA) ist für den angegebenen Zweck nicht als vertrauenswürdig markiert.

Grundlegende Erweiterungsfehler

INVALID_CA

Ein CA-Zertifikat ist ungültig. Es ist entweder kein CA oder seine Erweiterungen stimmen nicht mit dem angegebenen Zweck überein.

PATH_LENGTH_EXCEEDED

Der basicConstraints-Pfadlängenparameter wurde überschritten.

HOSTNAME_MISMATCH

Das Zertifikat stimmt nicht mit dem angegebenen Namen überein.

Nutzungs- und Richtlinienfehler

INVALID_PURPOSE

Das bereitgestellte Zertifikat kann nicht für den angegebenen Zweck verwendet werden.

CERT_REJECTED

Die Root-CA ist so markiert, dass der angegebene Zweck abgelehnt wird.

Formatierungsfehler

CERT_SIGNATURE_FAILURE

Die Signatur des Zertifikats ist ungültig.

CRL_SIGNATURE_FAILURE

Die Signatur der Zertifikatsperrliste (CRL) ist ungültig.

ERROR_IN_CERT_NOT_BEFORE_FIELD

Das Feld notBefore des Zertifikats enthält eine ungültige Zeit.

ERROR_IN_CERT_NOT_AFTER_FIELD

Das Feld notAfter des Zertifikats enthält eine ungültige Zeit.

ERROR_IN_CRL_LAST_UPDATE_FIELD

Das Feld lastUpdate der CRL enthält eine ungültige Zeit.

ERROR_IN_CRL_NEXT_UPDATE_FIELD

Das Feld nextUpdate der CRL enthält eine ungültige Zeit.

UNABLE_TO_DECRYPT_CERT_SIGNATURE

Die Zertifikatsignatur konnte nicht entschlüsselt werden. Dies bedeutet, dass der tatsächliche Signaturwert nicht bestimmt werden konnte, anstatt dass er nicht mit dem erwarteten Wert übereinstimmt. Dies ist nur für RSA-Schlüssel sinnvoll.

UNABLE_TO_DECRYPT_CRL_SIGNATURE

Die Signatur der Zertifikatsperrliste (CRL) konnte nicht entschlüsselt werden: Dies bedeutet, dass der tatsächliche Signaturwert nicht bestimmt werden konnte, anstatt dass er nicht mit dem erwarteten Wert übereinstimmt.

UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY

Der öffentliche Schlüssel in der SubjectPublicKeyInfo des Zertifikats konnte nicht gelesen werden.

Andere OpenSSL-Fehler

OUT_OF_MEM

Es ist ein Fehler beim Versuch der Speicherzuweisung aufgetreten. Dies sollte niemals vorkommen.