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.
AssertionError
s 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 Modulnode: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.
// 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 einError
-Objekt, das als erstes Argument an diese Funktion übergeben wird. Wenn dieses erste Argument nichtnull
ist und eine Instanz vonError
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 mittry…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.
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])
message
<string>options
<Object>cause
<any> Der Fehler, der den neu erstellten Fehler verursacht hat.
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])
targetObject
<Object>constructorOpt
<Function>
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.
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:
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.
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).
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.
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:
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
- Erweitert: <errors.Error>
Gibt das Fehlschlagen einer Assertion an. Details finden Sie unter Klasse: assert.AssertionError
.
Klasse: RangeError
- Erweitert: <errors.Error>
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.
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
- Erweitert: <errors.Error>
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.
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
- Erweitert: <errors.Error>
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.
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
- Erweitert: <errors.Error>
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 istcode
<string> Der String-Fehlercodedest
<string> Falls vorhanden, der Dateipfad-Zielort bei der Meldung eines Dateisystemfehlerserrno
<number> Die vom System bereitgestellte Fehlernummerinfo
<Object> Falls vorhanden, zusätzliche Details zum Fehlerzustandmessage
<string> Eine vom System bereitgestellte, menschenlesbare Beschreibung des Fehlerspath
<string> Falls vorhanden, der Dateipfad bei der Meldung eines Dateisystemfehlersport
<number> Falls vorhanden, der Netzwerkverbindungsport, der nicht verfügbar istsyscall
<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
oderhttps
) 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 Modulehttp
undnet
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 Sieulimit -n 2048
in derselben Shell aus, die den Node.js-Prozess ausführt.ENOENT
(Keine solche Datei oder kein solches Verzeichnis): Wird häufig vonfs
-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 vonfs.readdir
.ENOTEMPTY
(Verzeichnis nicht leer): Ein Verzeichnis mit Einträgen war das Ziel einer Operation, die ein leeres Verzeichnis erfordert, normalerweisefs.unlink
.ENOTFOUND
(DNS-Suche fehlgeschlagen): Zeigt einen DNS-Fehler von entwederEAI_NODATA
oderEAI_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 Ebenennet
undhttp
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 vonhttp
odernet
aufgetreten. Oft ein Zeichen dafür, dass einsocket.end()
nicht ordnungsgemäß aufgerufen wurde.
Klasse: TypeError
- Erweitert <errors.Error>
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
.
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 AbortSignal
s 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. Uint8Array
s werden in allen Node.js-Kern-APIs, in denen Buffer
s 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.1 | Die Fehlermeldung wurde wieder eingeführt. |
v11.12.0 | Die Fehlermeldung wurde entfernt. |
v10.5.0 | Hinzugefü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.
ERR_FS_CP_SYMLINK_TO_SUBDIRECTORY
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.
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.0 | require() 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.
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
.
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.
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.
ERR_VM_MODULE_LINK_FAILURE
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.0 | Maximale 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.0 | requireStack -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.
ERR_FS_INVALID_SYMLINK_TYPE
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.0 | Stattdessen wird eine DOMException ausgelöst. |
v21.0.0 | Entfernt 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.0 | Stattdessen wird eine DOMException ausgelöst. |
v21.0.0 | Entfernt in: v21.0.0 |
v15.0.0 | Hinzugefü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.0 | Anstatt 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.0 | Entfernt 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.0 | Anstatt 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.0 | Entfernt 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 SharedArrayBuffer
s im "externalisierten" Modus erstellen oder vorhandene SharedArrayBuffer
s 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).
Vertrauens- oder Kettenbezogene Fehler
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.
Namensbezogene Fehler
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.