...
Eroare Node.js · Module CommonJS: require și module.exports

TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received undefined

Pe scurt

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".

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

id este numele parametrului lui require(id): textul care spune ce modul vrei să încarci ("fs", "express", "./utils"). Mesajul spune că parametrul trebuie să fie de tip string, dar a primit altceva, aici undefined.

Asta nu se întâmplă când scrii calea direct în cod, ci când o iei dintr-o variabilă: require(config.modul), require(process.env.DRIVER), require(pluginuri[i]). Dacă proprietatea nu există (nume greșit, cheie lipsă în JSON, variabilă de mediu nesetată), valoarea e undefined, iar Node refuză încă dinainte să caute fișierul.

Partea Received ... îți arată ce a primit: undefined, type number (3), an instance of Object. În stiva de apeluri caută primul rând din fișierele tale (at Object.<anonymous> (/app/index.js:2:...)): acolo e require-ul cu problema.

De ce apare: cauzele frecvente

1Cheie scrisă greșit în configurație

Greșit
JavaScript
// config.json: { "formatare": "./formatare/lei" }
const config = require("./config.json");
const formateaza = require(config.formatter);
Corect
JavaScript
const config = require("./config.json");
const formateaza = require(config.formatare);

config.formatter nu există, deci e undefined. Cu numele corect al cheii primești calea, iar require găsește modulul.

2Variabilă de mediu nesetată

Greșit
JavaScript
const driver = require(process.env.DB_DRIVER);
Corect
JavaScript
const driver = require(process.env.DB_DRIVER || "./db/memorie");

Variabilele de mediu lipsă sunt undefined. O valoare implicită face programul să meargă și pe un calculator unde nu ai setat variabila.

3Obiect în loc de text

Greșit
JavaScript
const pluginuri = [{ cale: "./pluginuri/tva" }];
for (const p of pluginuri) require(p);
Corect
JavaScript
const pluginuri = [{ cale: "./pluginuri/tva" }];
for (const p of pluginuri) require(p.cale);

require primește doar text. Din obiect trebuie să iei proprietatea care conține calea.

Repară tu

Repară eroarea, direct în pagină

Programul încarcă funcția de formatare a prețurilor după calea scrisă în config.json, dar cheia folosită în cod nu există în fișier, așa că primește TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received undefined. Folosește cheia corectă din configurație, ca programul să afișeze cele trei prețuri formatate.

Codul care dă eroarea
JavaScript
const config = require("./config.json");
const formateaza = require(config.formatter);

for (const suma of [42, 7.5, 120]) {
  console.log(formateaza(suma));
}
După reparație, programul afișează
42.00 lei
7.50 lei
120.00 lei
Indiciu

Deschide config.json și compară numele cheii cu cel din config.formatter.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received type number (3)
  • TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received an instance of Object
  • TypeError [ERR_INVALID_ARG_TYPE]: The "id" argument must be of type string. Received null

Cum o eviți pe viitor

  • Scrie căile de module direct în cod ori de câte ori poți: require("./formatare/lei").
  • Când calea vine din configurație sau din process.env, verific-o înainte: if (typeof cale !== "string") throw new Error("Lipsește calea modulului").
  • Pune valori implicite pentru variabilele de mediu: process.env.X || "./implicit".
  • La depanare, afișează valoarea: console.log({ cale }) chiar înainte de require.

Întrebări frecvente

Cu ce e diferită de Cannot find module?

La Cannot find module Node a primit un text, l-a căutat și nu a găsit fișierul. Aici nici nu a ajuns să caute: nu a primit deloc un text.

De ce apare doar pe serverul de producție?

Pentru că acolo lipsește o variabilă de mediu sau o cheie din fișierul de configurare pe care ai setat-o doar local. Verifică ce valori are procesul pe server.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.