Erori Node.js explicate: ce înseamnă și cum le repari
Mesajele de eroare Node.js pe care le primești cel mai des, fiecare explicat pe înțeles: ce înseamnă, de ce apare, cod greșit lângă cod corect și cum o repari. Înveți de la zero cu Curs Node.js: primele 15 lecții sunt gratuite.
Pagină coordonată de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
- 150erori
- 10capitole
- 83ușor
- 58mediu
- 9greu
Aici găsești erorile specifice Node.js pe care le primești când înveți sau lucrezi cu el, explicate pe înțeles: module care nu se găsesc, amestecul dintre require și import, fișiere și dosare lipsă (ENOENT, EISDIR, EEXIST), argumente de tip greșit (ERR_INVALID_ARG_TYPE), promisiuni respinse netratate, evenimente 'error' fără ascultător, porturi ocupate (EADDRINUSE), răspunsuri HTTP trimise de două ori și erorile clasice din Express. Pentru fiecare vezi ce înseamnă mesajul, de ce apare (cauzele frecvente, cu codul greșit lângă cel corect), cum îl repari și cum îl eviți data viitoare. Erorile de JavaScript pur (TypeError, SyntaxError din limbaj) sunt explicate separat, în erorile JavaScript.
Erorile sunt grupate pe capitole: module CommonJS, module ES, fișiere și căi, cod asincron, EventEmitter și stream-uri, Buffer, crypto și assert, servere HTTP și Express. Caută mesajul exact pe care l-ai primit în terminal, citește cauzele și compară-le cu codul tău, apoi repară programul direct în pagină, la „Repară tu”, și apasă „Rulează” ca să vezi că eroarea a dispărut.
Module CommonJS: require și module.exports
Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). Explicația completă → Ușor Repară tu Error: Cannot find module 'lodash' Pachetul cerut nu este instalat în node_modules: ai uitat npm install, l-ai instalat în alt dosar sau numele e scris greșit. Rulează npm install lodash (sau npm install dacă e deja în package.json) în dosarul proiectului, ori folosește o funcție inclusă în Node. Explicația completă → Ușor Repară tu SyntaxError: /app/config.json: Expected double-quoted property name in JSON at position 59 (line 5 column 1) Fișierul JSON încărcat cu require are o greșeală de sintaxă: de obicei o virgulă după ultimul element, ghilimele simple sau un comentariu. Mesajul îți dă fișierul și linia; scoate virgula de la final și pune cheile între ghilimele duble. Explicația completă → Mediu Repară tu TypeError: calcule.totalCos is not a function Modulul nu exportă funcția pe care o apelezi, așa că require îți dă un obiect fără ea. Cauza clasică în Node: ai scris exports = { totalCos } în loc de module.exports = { totalCos }, ai uitat exportul sau numele diferă. Exportă cu module.exports. Explicația completă → Ușor Repară tu ReferenceError: window is not defined Rulezi în Node cod scris pentru browser: în Node nu există window, document sau localStorage. Folosește echivalentele din Node (globalThis, process, fs) sau rulează codul acela doar în browser. Explicația completă → Mediu Repară tu TypeError: Class extends value #<Object> is not a constructor or null Clasa de după extends nu este o clasă, ci un obiect: de obicei modulul exportă { Produs }, iar tu scrii const Produs = require("./produs"). Ia clasa din obiect cu const { Produs } = require("./produs") sau exportă direct clasa cu module.exports = Produs. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received undefined Ai apelat require() cu o valoare care nu e text, de obicei undefined: o variabilă necompletată, o cheie scrisă greșit în config sau o variabilă de mediu lipsă. Afișează valoarea înainte de require și dă-i mereu o cale validă, de exemplu "./formatare/lei". Explicația completă → Ușor Repară tu Error [ERR_UNKNOWN_BUILTIN_MODULE]: No such built-in module: node:fs/promise Ai cerut cu prefixul node: un modul de bază care nu există, aproape mereu din cauza unei greșeli de scriere: node:fs/promise în loc de node:fs/promises, node:paths în loc de node:path. Corectează numele; lista exactă e în require("module").builtinModules. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_VALUE]: The argument 'id' must be a non-empty string. Received '' Ai apelat require(""), cu un text gol. De obicei calea vine dintr-o variabilă de mediu sau dintr-un argument care lipsește, iar codul pune "" ca valoare implicită. Folosește o cale reală ca valoare implicită sau verifică textul înainte de require. Explicația completă → Greu Repară tu Warning: Accessing non-existent property 'formatLei' of module exports inside circular dependency Două module se cer reciproc cu require (dependență circulară), iar unul citește un export al celuilalt înainte ca acesta să termine de rulat, deci primește undefined. Rupe ciclul: mută funcțiile comune într-un modul separat sau citește proprietatea abia în momentul în care o folosești. Explicația completă → Ușor Repară tu SyntaxError: Unexpected token 'export' Fișierul folosește export (sintaxa modulelor ES), dar Node îl rulează ca CommonJS, de obicei pentru că package.json are "type": "commonjs" sau fișierul are extensia .cjs. Fie scrii exporturile cu module.exports, fie treci proiectul pe module ES cu "type": "module". Explicația completă → Mediu Repară tu SyntaxError: Cannot use 'import.meta' outside a module import.meta există doar în modulele ES, iar fișierul tău e rulat ca CommonJS. În CommonJS ai deja __dirname și __filename, deci înlocuiește path.dirname(fileURLToPath(import.meta.url)) cu __dirname, sau treci fișierul pe module ES cu "type": "module" ori extensia .mjs. Explicația completă → Mediu Repară tu Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/format.js' is not defined by "exports" in /app/node_modules/preturi/package.json Pachetul are câmpul "exports" în package.json, care spune exact ce căi au voie să fie importate, iar calea ta internă (de exemplu pachet/lib/format.js) nu e în listă. Importă pachetul prin calea publică (de obicei doar numele lui) sau printr-o cale listată în "exports". Explicația completă → Mediu Repară tu Error: Cannot find module '/app/node_modules/formatare/dist/index.js'. Please verify that the package.json has a valid "main" entry Pachetul există în node_modules, dar câmpul "main" din package.json-ul lui arată spre un fișier care nu există (de obicei un build care n-a fost făcut). Repară "main" ca să indice fișierul real sau rulează build-ul pachetului; până atunci poți încărca direct fișierul existent. Explicația completă → Mediu Repară tu Error: Invalid package config /app/dist/package.json. Node a dat peste un package.json care nu e JSON valid (virgulă în plus, comentariu, ghilimele simple) în timp ce încărca un modul. Deschide fișierul din mesaj și repară-l; dacă e generat de un script, scrie-l cu JSON.stringify, nu cu text lipit de mână. Explicația completă → Module ES: import, export și "type": "module"
SyntaxError: Cannot use import statement outside a module Node încarcă fișierul ca modul CommonJS, unde import nu e permis. Ori treci pe require, ori spui că fișierul e modul ES: extensia .mjs sau "type": "module" în package.json. Fișierele .cjs și proiectele cu "type": "commonjs" acceptă doar require. Explicația completă → Ușor Repară tu ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". Explicația completă → Mediu Repară tu ReferenceError: __dirname is not defined in ES module scope În modulele ES nu există __dirname și __filename. Folosește import.meta.dirname și import.meta.filename (Node 20.11+) sau calculează-le din import.meta.url cu fileURLToPath și path.dirname. Explicația completă → Ușor Repară tu ReferenceError: module is not defined in ES module scope Folosești module.exports într-un fișier care e modul ES (are import, extensia .mjs sau "type": "module"). În modulele ES exporți cu export: module.exports = { a, b } devine export { a, b } sau export default. Explicația completă → Greu Repară tu Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/index.js not supported. Încerci să încarci cu require un modul care e scris ca modul ES (multe pachete noi, ca chalk 5 sau node-fetch 3, sunt doar ESM). Folosește import în loc de require, un import() dinamic, sau o versiune mai veche a pachetului care are CommonJS. Explicația completă → Ușor Repară tu Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/utils/preturi.js' imported from /app/index.js Un import dintr-un modul ES arată spre un fișier care nu există: calea e greșită sau lipsește extensia. În modulele ES extensia este obligatorie: import x from "./preturi.js", nu "./preturi". Verifică dosarul și numele fișierului. Explicația completă → Mediu Repară tu SyntaxError: The requested module './preturi.js' does not provide an export named 'formatLei' Importi cu acolade un nume pe care modulul nu îl exportă cu acel nume. De obicei funcția e exportată implicit (export default) și trebuie importată fără acolade, sau numele e scris diferit. Verifică exporturile modulului. Explicația completă → Ușor Repară tu TypeError [ERR_IMPORT_ATTRIBUTE_MISSING]: Module "file:///app/date/produse.json" needs an import attribute of "type: json" Într-un modul ES nu poți importa un fișier JSON fără să spui că e JSON. Scrie import produse from "./date/produse.json" with { type: "json" }. Alternativ, citește fișierul cu fs.readFileSync și JSON.parse. Explicația completă → Ușor Repară tu SyntaxError: Unexpected identifier 'assert' Folosești sintaxa veche import ... assert { type: "json" }, scoasă din Node 22. Înlocuiește cuvântul assert cu with: import config from "./config.json" with { type: "json" }. Explicația completă → Mediu Repară tu TypeError: Cannot assign to read only property 'port' of object '[object Module]' Încerci să modifici o valoare importată dintr-un modul ES. Importurile sunt doar pentru citire: nu poți scrie setari.port = 8080. Fă o copie (const config = { ...setari, port: 8080 }) sau exportă din modul o funcție care schimbă valoarea. Explicația completă → Ușor Repară tu SyntaxError: Export 'formatLei' is not defined in module În export { formatLei } ai pus un nume care nu există în fișier: funcția sau variabila are alt nume, a fost ștearsă ori e definită în alt modul. Exportă numele real (export { formateazaLei }) sau redenumește la export: export { formateazaLei as formatLei }. Explicația completă → Ușor Repară tu SyntaxError: Duplicate export of 'default' Un modul ES poate avea un singur export default, iar tu ai două (sau același nume exportat de două ori). Păstrează un singur export default și exportă restul cu nume: export { totalCos }. Explicația completă → Mediu Repară tu SyntaxError: Illegal return statement Ai scris return în afara unei funcții, la nivelul de sus al unui modul ES. În CommonJS Node acceptă asta, în modulele ES nu. Pune codul într-o funcție main() și ieși din ea cu return, sau folosește if / else. Explicația completă → Mediu Repară tu TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file fileURLToPath() transformă doar adrese file:// în căi de pe disc, iar tu i-ai dat o adresă http(s):// sau alt tip de URL. Pentru adresele web folosește new URL(adresa).pathname; fileURLToPath păstrează-l pentru import.meta.url și alte URL-uri file:. Explicația completă → Ușor Repară tu Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js În modulele ES nu poți importa un dosar (import ... from "./utils") și nici să lași Node să ghicească index.js. Scrie calea completă către fișier, cu extensie: import ... from "./utils/index.js". Explicația completă → Mediu Repară tu Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:' Ai dat lui import() o cale absolută Windows (C:\proiect\...), iar modulele ES o citesc ca URL cu protocolul "c:". Transformă calea în URL file:// cu pathToFileURL(cale).href din node:url înainte de import. Explicația completă → Mediu Repară tu SyntaxError: The requested module './utils/index.js' contains conflicting star exports for name 'formateaza' Fișierul index reexportă cu export * două module care au amândouă un export cu același nume, deci Node nu știe pe care să ți-l dea. Importă numele direct din modulul dorit sau reexportă-l explicit, cu redenumire: export { formateaza as formateazaLei } from "./bani.js". Explicația completă → Mediu Repară tu ReferenceError: Cannot determine intended module format because both 'require' and top-level await are present. If the code is intended to be CommonJS, wrap await in an async function. If the code is intended to be an ES module, replace require() with import. În același fișier folosești și require() (CommonJS) și await la nivelul de sus (doar în module ES), iar Node nu știe ce fel de modul e. Alege unul: pune codul cu await într-o funcție async (rămâi pe CommonJS) sau înlocuiește require cu import (treci pe module ES). Explicația completă → Mediu Repară tu TypeError [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier "#utils/format.js" is not defined in package /app/package.json imported from /app/index.js Un import care începe cu # (de exemplu "#utils/format.js") e un alias intern și trebuie declarat în câmpul "imports" din package.json. Adaugă aliasul acolo ("#utils/*": "./utils/*") sau folosește calea relativă obișnuită ("./utils/format.js"). Explicația completă → Mediu Repară tu TypeError [ERR_INVALID_ARG_VALUE]: The argument 'filename' must be a file URL object, file URL string, or absolute path string. Received undefined createRequire() a primit undefined în loc de adresa fișierului curent. Într-un modul ES apelează createRequire(import.meta.url): import.meta.url există în toate versiunile, spre deosebire de import.meta.filename (abia din Node 20.11) sau de o proprietate scrisă greșit. Explicația completă → Ușor Repară tu TypeError [ERR_IMPORT_ATTRIBUTE_TYPE_INCOMPATIBLE]: Module "file:///app/config.js" is not of type "json" Ai pus with { type: "json" } la importul unui fișier care nu e .json (de obicei un .js). Atributul se pune doar pe fișierele .json; un modul JavaScript se importă simplu, fără with. Explicația completă → Fișiere și căi: fs și path
Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Explicația completă → Ușor Repară tu Error: ENOENT: no such file or directory, scandir 'rapoarte' Încerci să listezi cu readdir un dosar care nu există. scandir este operația de citire a unui dosar. Verifică numele și calea dosarului, iar dacă dosarul poate lipsi, creează-l înainte cu fs.mkdirSync(dosar, { recursive: true }). Explicația completă → Ușor Repară tu Error: EISDIR: illegal operation on a directory, read Ai dat o cale de dosar unei funcții care lucrează cu fișiere, de exemplu readFileSync("date") când date e un dosar. Listează dosarul cu readdirSync și citește fișierele din el, sau completează calea până la fișier. Explicația completă → Ușor Repară tu Error: EEXIST: file already exists, mkdir 'rapoarte' Încerci să creezi un dosar care există deja. mkdirSync fără opțiuni dă eroare dacă dosarul e acolo. Folosește fs.mkdirSync("rapoarte", { recursive: true }), care nu aruncă eroare când dosarul există. Explicația completă → Ușor Repară tu Error: ENOTEMPTY: directory not empty, rmdir 'arhiva' Încerci să ștergi cu rmdir un dosar care mai conține fișiere. rmdir șterge doar dosare goale. Folosește fs.rmSync("arhiva", { recursive: true, force: true }) ca să ștergi dosarul cu tot conținutul. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object Încerci să scrii în fișier un obiect sau un tablou direct, dar writeFileSync și appendFileSync acceptă doar text sau Buffer. Transformă datele în text: JSON.stringify(date, null, 2) pentru JSON, sau String(numar) pentru numere. Explicația completă → Mediu Repară tu TypeError: fs.readFileSync is not a function Ai importat varianta cu promisiuni a modulului (require("fs/promises") sau fs.promises), care are doar funcții asincrone, fără Sync. Folosește await fs.readFile(...) din fs/promises, sau importă modulul obișnuit "fs" dacă vrei readFileSync. Explicația completă → Ușor Repară tu Error: ENOENT: no such file or directory, rename 'rapoarte/ianuarie.txt' -> 'arhiva/ianuarie.txt' Mutarea sau redenumirea a eșuat pentru că lipsește fie fișierul sursă, fie dosarul destinație. De obicei dosarul în care muți (arhiva) nu există încă. Creează-l înainte cu fs.mkdirSync("arhiva", { recursive: true }) și verifică ambele căi. Explicația completă → Ușor Repară tu Error: ENOENT: no such file or directory, unlink 'temp/export-2.csv' Încerci să ștergi un fișier care nu există (a fost deja șters sau calea e greșită). Dacă vrei doar ca fișierul să nu mai existe, folosește fs.rmSync(cale, { force: true }), care nu dă eroare când fișierul lipsește. Explicația completă → Mediu Repară tu Error: ENOTDIR: not a directory, scandir 'proiect/README.md' Ai cerut conținutul unui dosar (readdir), dar la calea dată e un fișier. Se întâmplă de obicei la parcurgerea recursivă a dosarelor, când intri și în fișiere. Verifică întâi cu fs.statSync(cale).isDirectory() sau folosește readdirSync cu { withFileTypes: true }. Explicația completă → Mediu Repară tu SyntaxError: Unexpected token '', "{"nume":""... is not valid JSON Fișierul JSON începe cu un caracter invizibil, BOM (U+FEFF), pus de unele editoare pe Windows, iar JSON.parse nu îl acceptă. Elimină-l după citire: fs.readFileSync(f, "utf8").replace(/^\uFEFF/, ""), apoi salvează fișierul ca „UTF-8” fără BOM. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_VALUE]: The argument 'flags' is invalid. Received 'append' Ai dat o valoare greșită pentru modul de deschidere a fișierului (flag). Node acceptă doar coduri scurte: "r" citire, "w" scriere de la zero, "a" adăugare la final, "wx" scriere doar dacă fișierul nu există. Pentru adăugare scrie { flag: "a" } sau folosește fs.appendFileSync. Explicația completă → Ușor Repară tu TypeError: The "fd" argument must be of type number. Received type string ('raport.txt') Funcțiile fs.writeSync, fs.readSync, fs.closeSync și fs.fstatSync lucrează cu un descriptor de fișier (un număr), nu cu numele fișierului. Deschide întâi fișierul cu const fd = fs.openSync(nume, "w"), lucrează cu fd, apoi închide-l cu fs.closeSync(fd). Sau folosește fs.writeFileSync / fs.appendFileSync, care primesc direct numele. Explicația completă → Mediu Repară tu Error: EBADF: bad file descriptor, write Încerci să scrii (sau să citești) printr-un descriptor de fișier care a fost deja închis. De obicei fs.closeSync(fd) e pus în buclă sau înainte de ultima scriere. Închide fișierul o singură dată, după ce ai terminat toate operațiile, ideal într-un finally. Explicația completă → Mediu Repară tu Error: EACCES: permission denied, open 'raport.txt' Sistemul de operare nu-i dă procesului Node voie să deschidă fișierul (de obicei pentru scriere): fișierul e doar-citire, aparține altui utilizator (creat cu sudo) sau e într-un dosar protejat. Repară drepturile (chmod / chown) sau scrie într-un dosar al tău; nu rula aplicația cu sudo. Explicația completă → Ușor Repară tu Error: Cannot copy date/ to a subdirectory of self date/backup Încerci să copiezi un dosar cu fs.cp / fs.cpSync într-un subdosar al lui însuși (de exemplu date în date/backup), ceea ce ar crea o copie fără sfârșit. Pune copia în afara dosarului sursă, de exemplu în backup/date. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "pathObject" argument must be of type object. Received type string ('raport.txt') path.format() primește un obiect cu părțile căii ({ dir, name, ext }), nu un string. Ca să schimbi extensia, desparte calea cu path.parse(), modifică obiectul (fără base) și dă-l lui path.format(); pentru lipit bucăți de cale folosește path.join(). Explicația completă → Asincron: callback-uri, promisiuni și timere
UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "Stoc insuficient". O promisiune a fost respinsă și nimeni nu a tratat eroarea: lipsește try/catch în jurul lui await sau .catch() la final. Din Node 15, o respingere netratată oprește programul. Adaugă try/catch (sau .catch) și respinge cu new Error(...), nu cu un text. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "cb" argument must be of type function. Received undefined Ai apelat o funcție asincronă din fs (readFile, writeFile, readdir...) fără callback, ca și cum ar întoarce direct rezultatul. Ori dai un callback (err, date) => {...}, ori folosești varianta Sync, ori fs/promises cu await. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "callback" argument must be of type function. Received undefined Ai dat lui setTimeout, setInterval sau setImmediate rezultatul unei funcții în loc de funcția însăși, de obicei scriind setTimeout(trimite(), 1000). Pune funcția fără paranteze, setTimeout(trimite, 1000), sau într-o funcție săgeată: setTimeout(() => trimite("Ana"), 1000). Explicația completă → Greu Repară tu Warning: Detected unsettled top-level await at file:///app/index.js:9 Un await de la nivelul de sus al unui modul ES așteaptă o promisiune care nu se mai rezolvă niciodată, iar Node se oprește cu codul de ieșire 13. De obicei lipsește apelul resolve() în new Promise sau evenimentul așteptat nu mai vine. Asigură-te că promisiunea se rezolvă sau se respinge pe orice drum. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received undefined util.promisify() a primit undefined (sau altceva) în loc de o funcție cu callback: numele funcției e scris greșit (fs.readfile în loc de fs.readFile) sau funcția nu există în modul. Verifică numele; pentru fs folosește direct fs.promises sau node:fs/promises. Explicația completă → Mediu Repară tu TimeoutOverflowWarning: 2592000000 does not fit into a 32-bit signed integer.
Timeout duration was set to 1. setTimeout și setInterval acceptă cel mult 2147483647 ms (aproximativ 24,8 zile). Peste această valoare, Node afișează warning-ul și rulează callback-ul după 1 ms, adică imediat. Pentru termene lungi, împarte așteptarea în bucăți mai mici sau salvează termenul și verifică-l periodic. Explicația completă → Ușor Repară tu TypeError: callback is not a function Funcția ta așteaptă un callback ca ultim argument, dar a fost apelată fără el (sau cu argumentele în altă ordine), așa că la final callback e undefined. Dă-i funcția care primește rezultatul: citeste(fisier, (err, date) => { ... }), sau rescrie funcția să întoarcă o promisiune. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "options.signal" property must be an instance of AbortSignal. Received an instance of AbortController Ai dat opțiunii signal obiectul AbortController în loc de semnalul lui. Scrie { signal: controller.signal }: controller-ul e telecomanda (are abort()), iar semnalul e ce primesc funcțiile care pot fi anulate. Explicația completă → Mediu Repară tu Error [ERR_FALSY_VALUE_REJECTION]: Promise was rejected with falsy value O funcție async trecută prin util.callbackify a fost respinsă cu o valoare falsy (undefined, null, 0, ""), iar Node o împachetează în această eroare, ca callback-ul să primească totuși un err. Respinge întotdeauna cu un obiect Error: throw new Error("motiv") sau Promise.reject(new Error("motiv")). Explicația completă → Mediu Repară tu DOMException [TimeoutError]: The operation was aborted due to timeout Un AbortSignal.timeout(ms) a expirat înainte să se termine operația (de obicei un fetch), iar operația a fost anulată. Verifică dacă limita e în milisecunde (5000, nu 5), mărește-o dacă serviciul e lent și prinde eroarea cu catch, verificând err.name === "TimeoutError". Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "delay" argument must be of type number. Received type string ('1000') setTimeout din timers/promises (sau scheduler.wait) a primit durata ca string, de exemplu dintr-o variabilă de mediu sau dintr-un JSON. Transformă valoarea în număr înainte: await setTimeout(Number(config.pauza)). Explicația completă → EventEmitter și stream-uri
Error [ERR_UNHANDLED_ERROR]: Unhandled error. ('Senzor deconectat') Un EventEmitter a emis evenimentul 'error' și nu are niciun ascultător pentru el, așa că Node oprește programul. Adaugă emitter.on("error", (err) => {...}) înainte de emit și emite obiecte Error, nu texte. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "listener" argument must be of type function. Received undefined Ai dat lui on, once sau addListener rezultatul unei funcții în loc de funcția însăși, de obicei emitter.on("comanda", trimiteEmail()). Scoate parantezele: emitter.on("comanda", trimiteEmail), sau folosește o funcție săgeată. Explicația completă → Mediu Repară tu Error [ERR_STREAM_WRITE_AFTER_END]: write after end Ai scris într-un stream (fișier sau răspuns HTTP) după ce l-ai închis cu end(). După end() nu mai poți scrie. Scrie toate datele întâi și apelează end() o singură dată, la final; ca să faci ceva după scriere, ascultă evenimentul 'finish'. Explicația completă → Mediu Repară tu MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 comanda listeners added to [EventEmitter]. MaxListeners is 10. Use emitter.setMaxListeners() to increase limit Ai adăugat mai mult de 10 ascultători pentru același eveniment pe același obiect, de obicei pentru că .on() e apelat într-o buclă, la fiecare cerere sau la fiecare apel de funcție. Înregistrează ascultătorul o singură dată, sau scoate-l cu .off() când nu mai e nevoie de el. Mărește limita doar dacă chiar ai nevoie de atâția ascultători. Explicația completă → Mediu Repară tu TypeError: this.emit is not a function În interiorul unui callback scris cu function, this nu mai este obiectul tău EventEmitter, ci altceva (un Timeout, un stream, undefined). Folosește o funcție săgeată, care păstrează this din metoda clasei, sau salvează obiectul într-o variabilă înainte de callback. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "event" argument must be an instance of Event. Received type string ('comanda') dispatchEvent din EventTarget primește un obiect Event, nu numele evenimentului ca text (asta e stilul lui EventEmitter.emit). Scrie target.dispatchEvent(new Event("comanda")), iar pentru date atașate new CustomEvent("comanda", { detail: { ... } }). Explicația completă → Ușor Repară tu TypeError [ERR_STREAM_NULL_VALUES]: May not write null values to stream Ai apelat write(null) pe un stream de scriere, de obicei crezând că null îl închide (asta se face doar la push(null) pe stream-urile de citire). Pentru a termina un stream de scriere apelează stream.end(); dacă null vine din date, sari peste valorile lipsă. Explicația completă → Buffer, crypto și assert
Error: Digest method not supported Numele algoritmului dat lui crypto.createHash sau createHmac nu e recunoscut, de obicei o greșeală de scriere: "sha265" în loc de "sha256" sau "SHA-256" cu cratimă. Folosește un nume valid, de exemplu "sha256", "sha512" sau "md5". Explicația completă → Mediu Repară tu Error [ERR_CRYPTO_HASH_FINALIZED]: Digest already called Ai apelat digest() de două ori pe același obiect Hash sau Hmac, sau ai făcut update() după digest(). Un hash se poate finaliza o singură dată: salvează rezultatul lui digest() într-o variabilă și creează un hash nou pentru fiecare text. Explicația completă → Mediu Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. Explicația completă → Ușor Repară tu TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: Expected values to be strictly equal: Un test cu assert.strictEqual a picat: valoarea obținută (actual) nu e identică (===) cu cea așteptată (expected). Sub mesaj vezi cele două valori. Repară codul testat, nu testul, dacă așteptarea e corectă; atenție la tipuri: "15" și 15 nu sunt egale. Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: The expression evaluated to a falsy value: Un assert(...) sau assert.ok(...) a primit o valoare falsă (false, 0, "", null, undefined). Sub mesaj Node arată chiar expresia din cod, de exemplu assert(esteEmailValid("ana@exemplu.ro")). Verifică de ce expresia e falsă: de obicei funcția testată are un bug. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: Values have same structure but are not reference-equal: Ai comparat două obiecte (sau tablouri) cu assert.strictEqual, care verifică dacă sunt același obiect în memorie, nu dacă au același conținut. Pentru conținut folosește assert.deepStrictEqual(actual, asteptat). Explicația completă → Mediu Repară tu AssertionError [ERR_ASSERTION]: Missing expected exception. assert.throws() aștepta ca funcția să arunce o eroare, dar funcția a rulat fără eroare. Ori codul testat are un bug (validarea lipsește sau e greșită), ori funcția e async și întoarce o promisiune respinsă, caz în care trebuie await assert.rejects(). Explicația completă → Mediu Repară tu AssertionError [ERR_ASSERTION]: Missing expected rejection. await assert.rejects() aștepta ca promisiunea să fie respinsă, dar ea s-a rezolvat normal. Funcția async testată întoarce o valoare (de exemplu null) în loc să arunce o eroare. Aruncă eroarea în funcție sau schimbă testul să verifice valoarea întoarsă. Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: The input did not match the regular expression /^RO\d{2}[A-Z]{4}/. Input: assert.match(text, regex) a pică: textul primit nu se potrivește cu expresia regulată. Sub mesaj vezi exact textul (Input). Compară-l cu modelul: de obicei e o diferență de litere mari/mici, un spațiu în plus sau un format greșit produs de cod. Explicația completă → Mediu Repară tu TypeError [ERR_AMBIGUOUS_ARGUMENT]: The "error/message" argument is ambiguous. The error message "Împărțire la zero" is identical to the message. Ai dat lui assert.throws un text ca al doilea argument, iar textul e chiar mesajul erorii. Pentru assert.throws, un text este mesajul afișat când testul pică, nu eroarea așteptată. Scrie modelul ca expresie regulată (/Împărțire la zero/) sau ca obiect ({ message: "Împărțire la zero" }). Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "fn" argument must be of type function. Received undefined Ai dat lui assert.throws sau assert.doesNotThrow rezultatul funcției, nu funcția: assert.doesNotThrow(adauga(cos)) rulează adauga imediat și trimite ce întoarce (aici undefined). Învelește apelul într-o funcție: assert.doesNotThrow(() => adauga(cos)). Explicația completă → Mediu Repară tu RangeError [ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH]: Input buffers must have the same byte length crypto.timingSafeEqual(a, b) compară doar buffere de aceeași lungime și aruncă dacă lungimile diferă, de exemplu când semnătura primită e trunchiată sau lipsește. Verifică întâi a.length === b.length și tratează diferența ca „invalid”. Explicația completă → Mediu Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "string" argument must be of type string or an instance of Buffer or ArrayBuffer. Received undefined Buffer.byteLength() a primit undefined în loc de text, cel mai des pentru că JSON.stringify(undefined) întoarce undefined, nu un text. Asta se întâmplă când datele trimise lipsesc (find() nu a găsit nimic). Tratează lipsa datelor înainte, de exemplu cu un răspuns 404. Explicația completă → Ușor Repară tu RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range. It must be >= 0 and <= 3. Received 4 Citești sau scrii într-un Buffer la o poziție (offset) care depășește lungimea lui. Mesajul îți dă intervalul permis și valoarea primită. De obicei e o buclă cu i <= buf.length în loc de i < buf.length, sau un câmp citit dintr-un pachet mai scurt decât crezi. Explicația completă → Mediu Repară tu RangeError [ERR_BUFFER_OUT_OF_BOUNDS]: Attempt to access memory outside buffer bounds Încerci să citești sau să scrii un câmp mai mare decât tot bufferul, de exemplu 4 octeți (readInt32BE) dintr-un buffer de 2. Verifică dimensiunea câmpului din format (16 sau 32 de biți?) și lungimea bufferului, de obicei rezultatul unui slice sau subarray. Explicația completă → Ușor Repară tu RangeError [ERR_OUT_OF_RANGE]: The value of "value" is out of range. It must be >= 0 and <= 255. Received 300 Numărul pe care îl scrii nu încape în tipul ales: writeUInt8 acceptă 0-255, writeInt8 -128..127, writeUInt16BE 0-65535. Alege un tip mai mare (writeUInt16BE, writeUInt32BE) și alocă bufferul cu octeții necesari, sau validează valoarea înainte. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string ('16') Buffer.alloc, Buffer.allocUnsafe și crypto.randomBytes primesc dimensiunea ca număr, iar tu ai dat un text (de obicei citit din process.env, dintr-un JSON sau din query string). Convertește valoarea cu Number(...) sau parseInt(..., 10) și verifică să fie un întreg pozitiv. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "list[0]" argument must be an instance of Buffer or Uint8Array. Received type string ('{"id":') Buffer.concat lipește doar Buffer-e, iar în listă ai și texte (de obicei bucăți transformate cu toString sau primite cu setEncoding). Păstrează bucățile ca Buffer și transformă în text abia la final, sau, dacă ai deja texte, lipește-le cu join(""). Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array. Received type string ('581ce21e4af9c83e5b8b...') buf.equals() și Buffer.compare compară doar două Buffer-e, iar tu ai dat un text (de obicei un hash în hex sau base64). Transformă textul în Buffer cu Buffer.from(text, "hex"), sau compară două texte: hash.toString("hex") === asteptat. Explicația completă → Mediu Repară tu DOMException [InvalidCharacterError]: Invalid character atob() a primit un text care nu e Base64 standard: de obicei Base64URL (cu - și _ în loc de + și /), cum sunt părțile unui token JWT, sau un text cu spații și alte caractere. În Node decodează cu Buffer.from(text, "base64url").toString("utf8"), care acceptă și lipsa padding-ului. Explicația completă → Ușor Repară tu RangeError [ERR_OUT_OF_RANGE]: The value of "max" is out of range. It must be greater than the value of "min" (1000000). Received 100000 crypto.randomInt(min, max) primește întâi minimul și apoi maximul, iar maximul e exclus. Ai dat argumentele invers (sau egale). Scrie crypto.randomInt(100000, 1000000) pentru un cod de 6 cifre, iar crypto.randomInt(n) pentru un număr între 0 și n-1. Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: Expected "actual" to be strictly unequal to: 1 Testul cu assert.notStrictEqual(a, b) a picat pentru că cele două valori sunt identice (===), deși trebuiau să difere. Valoarea de după două puncte e cea primită. Verifică de ce codul testat întoarce de două ori același rezultat: o stare care nu se actualizează, un cache sau o copie care nu e de fapt nouă. Explicația completă → Mediu Repară tu AssertionError [ERR_ASSERTION]: Got unwanted exception.
Actual message: "Cantitate invalidă: 100" assert.doesNotThrow(fn) a picat pentru că fn a aruncat o eroare, deși testul spunea că nu trebuie. Mesajul de după Actual message e eroarea aruncată de codul tău: pornește de la ea. De obicei e o condiție de validare greșită la limită (< în loc de <=). Explicația completă → Mediu Repară tu AssertionError [ERR_ASSERTION]: The error is expected to be an instance of "TypeError". Received "RangeError" assert.throws(fn, TypeError) a primit o eroare, dar de alt tip decât cel cerut. Mesajul spune tipul așteptat și tipul primit, iar dedesubt mesajul erorii. De obicei verificările din cod sunt în ordinea greșită (întâi intervalul, apoi tipul) sau codul aruncă un Error generic. Explicația completă → Mediu Repară tu TypeError [ERR_INVALID_RETURN_VALUE]: Expected instance of Promise to be returned from the "promiseFn" function but got undefined. assert.rejects (sau doesNotReject) a primit o funcție care nu întoarce promisiunea, de obicei o săgeată cu acolade fără return: () => { gaseste(99); }. Scrie () => gaseste(99) sau adaugă return, ori dă direct promisiunea: assert.rejects(gaseste(99), ...). Explicația completă → Ușor Repară tu AssertionError [ERR_ASSERTION]: The "string" argument must be of type string. Received type number (400001) assert.match(valoare, /regex/) cere ca valoarea să fie text, iar tu ai dat un număr (sau undefined, null, un obiect). Verifică de ce funcția testată nu întoarce un șir; dacă valoarea e un cod (poștal, de produs, telefon), păstreaz-o ca text în date, nu ca număr. Explicația completă → Mediu Repară tu RangeError: Invalid key length Cheia dată lui crypto.createCipheriv nu are lungimea cerută de algoritm: aes-256 vrea exact 32 de octeți, aes-128 vrea 16. Nu folosi parola ca text drept cheie: derivă cheia cu crypto.scryptSync(parola, sare, 32) sau folosește o cheie aleatoare de 32 de octeți. Explicația completă → Mediu Repară tu TypeError: Invalid initialization vector IV-ul (vectorul de inițializare) dat lui createCipheriv / createDecipheriv nu are lungimea cerută: 16 octeți la aes-*-cbc și aes-*-ctr, de obicei 12 la aes-*-gcm. Generează-l cu crypto.randomBytes(16), salvează-l lângă textul criptat și citește-l cu aceeași codificare (hex sau base64). Explicația completă → Greu Repară tu Error: error:1C800064:Provider routines::bad decrypt Decriptarea a eșuat la final(): cheia sau IV-ul folosite la decriptare nu sunt aceleași cu cele de la criptare (sau datele s-au stricat), așa că padding-ul nu iese corect. Folosește exact aceeași cheie, același algoritm și același IV ca la criptare. Explicația completă → Greu Repară tu Error: error:1C80006B:Provider routines::wrong final block length Textul criptat dat la decriptare nu are o lungime multiplu de 16 octeți, deci nu e exact ce a ieșit la criptare: de obicei e citit cu altă codificare (base64 citit ca hex sau invers) sau e trunchiat. Decodează-l cu aceeași codificare cu care l-ai salvat. Explicația completă → Greu Repară tu Error: Unsupported state or unable to authenticate data La AES-GCM, verificarea autenticității a eșuat la final(): tag-ul, IV-ul sau cheia nu sunt cele de la criptare ori textul criptat a fost modificat. Salvează IV-ul și tag-ul (getAuthTag după final) lângă date și folosește-le neschimbate la decriptare, cu setAuthTag înainte de final(). Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received undefined crypto.pbkdf2 / pbkdf2Sync cer ca ultim argument algoritmul de hash (de exemplu "sha512"), iar tu l-ai omis, cum se făcea în tutorialele vechi. Adaugă-l: crypto.pbkdf2Sync(parola, sare, 100000, 64, "sha512"). Explicația completă → Greu Repară tu Error: error:1E08010C:DECODER routines::unsupported OpenSSL nu a putut citi cheia dată (createPrivateKey, createSign, jwt.sign cu RS256): textul nu e un PEM valid. De obicei cheia din .env are \n scrise ca text în loc de rânduri noi sau i-au fost tăiate liniile BEGIN / END. Refă rândurile noi cu .replace(/\\n/g, "\n"). Explicația completă → Mediu Repară tu TypeError: The encoded data was not valid for encoding utf-8 Un TextDecoder creat cu { fatal: true } a primit octeți care nu sunt UTF-8 valid, de obicei un fișier salvat în altă codificare (Windows-1250, Latin-1), cum exportă Excel-ul vechi. Decodează cu codificarea reală a fișierului, de exemplu new TextDecoder("windows-1250"), sau cere fișierul în UTF-8. Explicația completă → Ușor Repară tu RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "base64" encoding is not supported TextDecoder / TextEncoder acceptă doar codificări de caractere (utf-8, utf-16le, windows-1250...), nu base64, hex sau nume inventate. Pentru base64 și hex folosește Buffer: Buffer.from(text, "base64").toString("utf8"). Explicația completă → Ușor Repară tu TypeError [ERR_MISSING_ARGS]: The "actual" and "expected" arguments must be specified Ai apelat assert.strictEqual / deepStrictEqual (sau equal) cu un singur argument: lipsește valoarea așteptată. Scrie ambele valori: assert.strictEqual(rezultat, asteptat). Dacă vrei doar să verifici că o valoare e adevărată, folosește assert.ok(valoare). Explicația completă → Server HTTP, fetch și porturi
Error: listen EADDRINUSE: address already in use :::3000 Portul pe care vrei să pornești serverul e deja ocupat: o altă instanță a aplicației (pornită în alt terminal sau rămasă agățată) sau alt program îl folosește. Oprește procesul vechi (Ctrl+C, sau găsește-l cu lsof -i :3000) ori pornește serverul pe alt port. Explicația completă → Mediu Repară tu Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client Încerci să trimiți al doilea răspuns la aceeași cerere: după res.end, res.send sau res.json ai mai apelat res.json, res.status sau res.setHeader. De obicei lipsește un return după răspunsul de eroare. Scrie return res.status(404).json(...). Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "chunk" argument must be of type string or an instance of Buffer or Uint8Array. Received type number (235) Ai dat lui res.write sau res.end (sau unui stream) un număr, un obiect ori un tablou, dar acceptă doar text sau Buffer. Transformă valoarea: res.end(String(total)) pentru numere, res.end(JSON.stringify(date)) pentru obiecte; în Express folosește res.json(date). Explicația completă → Ușor Repară tu Error: connect ECONNREFUSED 127.0.0.1:3000 Programul tău încearcă să se conecteze la un server care nu ascultă la adresa și portul acela: serverul nu e pornit, s-a oprit sau folosești alt port. Pornește serverul (sau baza de date) și verifică portul din URL. Cu fetch, eroarea apare ca TypeError: fetch failed, cu ECONNREFUSED în cause. Explicația completă → Ușor Repară tu Error: getaddrinfo ENOTFOUND api.exemplu.ro Numele serverului din URL nu a putut fi găsit în DNS: e scris greșit (locahost, api.exmplu.ro), conține protocolul sau calea în locul greșit, ori nu ai conexiune la internet. Verifică numele de domeniu din URL sau din variabila de mediu. Cu fetch apare ca TypeError: fetch failed. Explicația completă → Ușor Repară tu TypeError: Invalid URL new URL() a primit un text care nu e o adresă completă, de obicei o cale relativă ca req.url ("/produse?pagina=2"), fără protocol și domeniu. Dă-i și o bază: new URL(req.url, "http://localhost"). În eroare, câmpul input arată exact textul primit. Explicația completă → Ușor Repară tu TypeError: Failed to parse URL from /api/produse În Node, fetch() are nevoie de adresa completă, cu protocol și domeniu: fetch("http://localhost:3000/api/produse"). O cale relativă ("/api/produse") merge doar în browser, unde există pagina curentă ca bază. Explicația completă → Mediu Repară tu TypeError: Body is unusable: Body has already been read Ai citit de două ori corpul aceluiași răspuns fetch, de exemplu întâi await r.text() și apoi await r.json(). Corpul se poate citi o singură dată. Citește-l o dată ca text și parsează-l cu JSON.parse, sau folosește r.clone() înainte de prima citire. Explicația completă → Ușor Repară tu TypeError: Request with GET/HEAD method cannot have body. Ai trimis cu fetch un body fără să schimbi metoda, iar metoda implicită e GET, care nu poate avea corp. Adaugă method: "POST" (sau PUT, PATCH). Dacă vrei totuși GET, pune datele în query string: ?categorie=cafea. Explicația completă → Greu Repară tu TypeError: parametri.hasOwnProperty is not a function Obiectul întors de querystring.parse() (și alte obiecte create cu Object.create(null)) nu are prototip, deci nu are metoda hasOwnProperty. Folosește Object.hasOwn(parametri, "cheie") sau "cheie" in parametri. Explicația completă → Mediu Repară tu TypeError: Response.clone: Body has already been consumed. Ai apelat r.clone() după ce ai citit deja corpul răspunsului (cu json(), text() etc.). O copie se poate face doar cât timp corpul e necitit. Mută r.clone() înainte de prima citire sau păstrează datele citite în loc de răspuns. Explicația completă → Express
Cannot GET /api/produs Express nu are nicio rută care să se potrivească cu metoda și calea cererii, așa că răspunde 404 cu Cannot GET /cale. Verifică litera cu literă calea din client și din app.get, metoda (GET vs POST), prefixul din app.use("/api", router) și ordinea în care sunt înregistrate rutele. Explicația completă → Ușor Repară tu TypeError: Cannot destructure property 'nume' of 'req.body' as it is undefined. req.body este undefined pentru că Express nu citește singur corpul cererii: lipsește app.use(express.json()) (sau express.urlencoded() pentru formulare), e pus după rute, ori clientul nu trimite Content-Type: application/json. Adaugă middleware-ul înaintea rutelor. Explicația completă → Mediu Repară tu TypeError: Router.use() requires a middleware function but got a Object Ai dat lui app.use sau router.use un obiect în loc de o funcție middleware sau de un router. Cel mai des, fișierul cu rute exportă { router } sau nu exportă nimic (module.exports lipsește). Exportă routerul cu module.exports = router și folosește-l așa cum e exportat. Explicația completă → Mediu Repară tu Error: Route.get() requires a callback function but got a [object Undefined] Funcția dată ca handler pentru app.get, app.post sau router.get este undefined: e importată cu alt nume decât cel exportat, nu e exportată din controller sau e scrisă greșit. Verifică exporturile controllerului și numele folosit în rută. Explicația completă → Ușor Repară tu TypeError: res.status is not a function Variabila res nu e obiectul răspuns Express: de obicei parametrii handler-ului sunt inversați ((res, req) în loc de (req, res)), handler-ul de erori are doar 3 parametri în loc de 4, sau folosești modulul http simplu, unde res nu are status() și json(). Verifică ordinea: (req, res, next) și (err, req, res, next). Explicația completă → Mediu Repară tu Internal Server Error Codul unei rute a aruncat o eroare netratată, iar Express a răspuns cu 500 și pagina „Internal Server Error”. Cauza reală e în consola serverului, cu stiva de apeluri. Repară eroarea de acolo (de obicei o valoare lipsă) și răspunde explicit cu 400 sau 404 pentru situațiile așteptate. Explicația completă → Ușor Repară tu TypeError: express is not a function Variabila express nu e funcția exportată de pachet, pentru că ai importat-o greșit: import * as express from "express", const { express } = require("express") sau require("express").default. Scrie import express from "express" (module ES) sau const express = require("express") (CommonJS). Explicația completă → Ușor Repară tu SyntaxError: Unexpected token 'o', "[object Obj"... is not valid JSON Serverul a primit textul "[object Object]" în loc de JSON, pentru că clientul a trimis un obiect în body fără JSON.stringify. Express răspunde cu 400 Bad Request. Scrie body: JSON.stringify(date) și antetul Content-Type: application/json. Explicația completă → Greu Repară tu TypeError: Cannot set property query of #<IncomingMessage> which has only a getter În Express 5, req.query e doar pentru citire (un getter), așa că req.query = {...} dă eroare. Apare în middleware-uri proprii sau în pachete vechi scrise pentru Express 4. Pune valorile prelucrate în altă proprietate, de exemplu req.filtre sau res.locals.filtre. Explicația completă → Ușor Repară tu ReferenceError: next is not defined Middleware-ul tău apelează next(), dar funcția nu are parametrul next: e declarată (req, res) în loc de (req, res, next). Adaugă al treilea parametru. Express dă next fiecărui middleware, dar doar dacă îl primești în lista de parametri. Explicația completă → Mediu Repară tu TypeError: Cannot read properties of undefined (reading 'headers') În Express, eroarea apare de obicei când apelezi un middleware la înregistrare, auth() în loc de auth, așa că funcția rulează imediat, fără cerere, iar req e undefined. Dă rutei funcția însăși: app.get("/api", auth, handler). Altă cauză: parametrii (req, res) inversați sau un handler apelat de mână. Explicația completă → Proces, terminal și intrare de la tastatură
Error: ENOENT: no such file or directory, chdir '/app' -> 'build' process.chdir() a încercat să intre într-un dosar care nu există. Mesajul arată dosarul curent ('/app') și ținta ('build'). Verifică numele dosarului (de exemplu dist în loc de build) sau creează-l înainte cu fs.mkdirSync(dosar, { recursive: true }). Explicația completă → Mediu Repară tu Error [ERR_USE_AFTER_CLOSE]: readline was closed Ai apelat rl.question() (sau alt apel readline) după ce interfața s-a închis: fie ai apelat rl.close() prea devreme, fie intrarea s-a terminat (Ctrl+D sau date trimise prin pipe), iar readline s-a închis singur. Pune rl.close() după ultima întrebare și nu mai întreba nimic în handler-ul close. Explicația completă → Mediu Repară tu TypeError: process.stdout.clearLine is not a function process.stdout.clearLine, cursorTo și setRawMode există doar când ieșirea (sau intrarea) e un terminal. Când rulezi prin pipe, în CI, în Docker fără -t sau în unele editoare, stdout e un flux simplu și metodele lipsesc. Verifică process.stdout.isTTY și afișează altfel când e false. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_TYPE]: The "code" argument must be of type number. Received type string ('eroare') process.exit() și process.exitCode primesc un cod numeric: 0 înseamnă succes, orice altceva (de obicei 1) înseamnă eroare. De la Node 20, un text ca "eroare" nu mai e acceptat. Afișează mesajul cu console.error și ieși cu process.exit(1), sau setează process.exitCode = 1. Explicația completă → Ușor Repară tu TypeError [ERR_INVALID_ARG_VALUE]: The argument 'format' must be one of: 'reset', 'bold', 'dim', 'italic', 'underline', 'blink', 'inverse', 'hidden', 'strikethrough', 'doubleunderline', 'black', 'red', 'green', ... Received 'rosu' util.styleText(format, text) acceptă doar numele de stiluri cunoscute de Node, în engleză: "red", "green", "yellow", "bold", "underline", "bgRed" și altele. Ai scris un nume inexistent (de exemplu "rosu" sau "Red"). Corectează numele; pentru mai multe stiluri dă un tablou: styleText(["bold", "green"], text). Explicația completă → Mediu Repară tu Error: kill ESRCH process.kill(pid) a fost apelat pentru un proces care nu mai există (ESRCH = no such process), de obicei un PID vechi rămas într-un fișier .pid după o oprire bruscă. Prinde eroarea: dacă err.code === "ESRCH", procesul e deja oprit, deci șterge fișierul .pid și continuă. Explicația completă → Ușor Repară tu TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--prot' util.parseArgs a primit o opțiune care nu e definită în options, de obicei scrisă greșit (--prot în loc de --port) sau nedeclarată. Adaugă opțiunea în options ori corectează comanda; dacă vrei să accepți și opțiuni necunoscute, pune strict: false. Explicația completă → Ușor Repară tu TypeError [ERR_PARSE_ARGS_INVALID_OPTION_VALUE]: Option '-p, --port <value>' argument missing Opțiunea e declarată cu type: "string", deci așteaptă o valoare după ea, dar comanda nu i-a dat-o (node server.js --port). Scrie valoarea (--port 8080 sau --port=8080), iar dacă opțiunea e doar un comutator, declar-o cu type: "boolean". Explicația completă → Ușor Repară tu TypeError [ERR_PARSE_ARGS_UNEXPECTED_POSITIONAL]: Unexpected argument 'raport.txt'. This command does not take positional arguments util.parseArgs a primit un argument fără -- în față (de exemplu un nume de fișier), dar nu i-ai permis argumente poziționale. Adaugă allowPositionals: true și citește-le din positionals, sau transformă argumentul într-o opțiune (--fisier raport.txt). Explicația completă → Versiuni Node: API-uri depreciate și eliminate
[DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead. Codul (al tău sau al unui pachet) creează bufferuri cu new Buffer(...) sau Buffer(...), formă depreciată de mult timp. Înlocuiește-o cu Buffer.from(text sau tablou) când ai date, și cu Buffer.alloc(n) când ai nevoie de un buffer gol de n octeți. Explicația completă → Ușor Repară tu [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead. CVEs are not issued for `url.parse()` vulnerabilities. url.parse() e vechiul parser de adrese al lui Node, care tratează unele URL-uri altfel decât browserele și poate fi păcălit. Folosește new URL(adresa) și url.searchParams.get("cheie"); pentru adrese relative, dă și o bază: new URL(req.url, "http://localhost"). Explicația completă → Ușor Repară tu [DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead. util._extend(tinta, sursa) e o funcție internă veche a lui Node pentru copierea proprietăților dintr-un obiect în altul. Înlocuiește-o cu Object.assign(tinta, sursa) sau, ca să nu modifici obiectul original, cu { ...implicit, ...setari }. Explicația completă → Ușor Repară tu [DEP0147] DeprecationWarning: In future versions of Node.js, fs.rmdir(path, { recursive: true }) will be removed. Use fs.rm(path, { recursive: true }) instead Ștergerea unui dosar cu tot conținutul prin fs.rmdir / fs.rmdirSync cu { recursive: true } e depreciată. Folosește fs.rmSync(cale, { recursive: true, force: true }) sau fs.promises.rm(...): face același lucru și, cu force: true, nu dă eroare dacă dosarul nu există. Explicația completă → Ușor Repară tu [DEP0044] DeprecationWarning: The `util.isArray` API is deprecated. Please use `Array.isArray()` instead. util.isArray e o funcție veche a lui Node, depreciată la rulare din Node 22, înlocuită de mult de funcția standard Array.isArray. Înlocuiește util.isArray(x) cu Array.isArray(x); dacă warning-ul vine dintr-un pachet, actualizează-l. Explicația completă → Mediu Repară tu TypeError: util.isString is not a function Funcțiile vechi util.isString, util.isNumber, util.isFunction, util.isObject, util.isDate, util.isError, util.log și altele au fost eliminate în Node 23. Înlocuiește-le cu verificările standard: typeof x === "string", typeof x === "number", x instanceof Date, console.log. Dacă eroarea vine dintr-un pachet, actualizează-l. Explicația completă → Mediu Repară tu [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead. Codul tău sau, mult mai des, un pachet din node_modules (tr46, whatwg-url, uri-js, versiuni vechi de node-fetch, ajv, eslint) încarcă modulul intern punycode, depreciat din Node 21. E doar un avertisment: actualizează pachetele; în codul tău folosește url.domainToASCII() sau new URL(). Explicația completă → Mediu Repară tu TypeError: crypto.createCipher is not a function crypto.createCipher și crypto.createDecipher au fost eliminate în Node 22, după ani de depreciere (DEP0106), pentru că derivau cheia din parolă într-un mod nesigur. Folosește crypto.createCipheriv cu o cheie de 32 de octeți (de exemplu din crypto.scryptSync) și un IV aleator salvat lângă date. Explicația completă → Ușor Repară tu [DEP0176] DeprecationWarning: fs.F_OK is deprecated, use fs.constants.F_OK instead Constantele fs.F_OK, fs.R_OK, fs.W_OK și fs.X_OK, folosite cu fs.access, sunt depreciate la rulare din Node 24. Scrie fs.constants.F_OK (și restul la fel); valorile sunt aceleași, doar locul s-a schimbat. Explicația completă → Nicio eroare nu se potrivește căutării. Încearcă doar partea fixă a mesajului (fără numele variabilelor).
Erori explicate la alte tehnologii
Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
