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)).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Versiunea cu promisiuni a lui setTimeout (const { setTimeout } = require("timers/promises")) verifică strict argumentul delay: trebuie să fie număr. Mesajul Received type string ('1000') îți arată și valoarea primită.
E o diferență față de setTimeout clasic, care transformă în tăcere string-ul în număr. De aceea codul mergea înainte și se strică după ce treci la await setTimeout(...).
Valorile vin ca string din surse externe: process.env.PAUZA_MS (variabilele de mediu sunt mereu string-uri), argumentele din linia de comandă (process.argv), parametrii din URL (req.query) sau un JSON în care numărul a fost scris între ghilimele. Linia din stivă cu fișierul tău arată apelul setTimeout.
De ce apare: cauzele frecvente
1Pauză citită din variabila de mediu
const { setTimeout: asteapta } = require("timers/promises");
await asteapta(process.env.PAUZA_MS || 1000);const { setTimeout: asteapta } = require("timers/promises");
await asteapta(Number(process.env.PAUZA_MS) || 1000);process.env.PAUZA_MS e string ("500"). Number(...) îl face număr, iar || 1000 acoperă lipsa sau o valoare invalidă (NaN).
2Număr scris între ghilimele în JSON
// config.json: { "reincercare": "2000" }
await asteapta(config.reincercare);// config.json: { "reincercare": 2000 }
await asteapta(config.reincercare);În JSON, "2000" e string, iar 2000 e număr. Repară datele sau convertește la citire.
3Argument din linia de comandă
const [, , secunde] = process.argv;
await asteapta(secunde * 1000 + "");const [, , secunde] = process.argv;
await asteapta(Number(secunde) * 1000);process.argv conține doar string-uri; înmulțirea dă număr, dar lipirea cu "" îl face din nou string.
Repară eroarea, direct în pagină
Scriptul trimite notificările una câte una, cu o pauză între ele citită din setari.json. Acolo pauza e scrisă ca text ("20"), iar setTimeout din timers/promises oprește scriptul cu The "delay" argument must be of type number. Fără să modifici setari.json, convertește pauza în număr, ca scriptul să trimită cele trei notificări.
const fs = require("fs");
const { setTimeout: asteapta } = require("timers/promises");
const setari = JSON.parse(fs.readFileSync("setari.json", "utf8"));
const clienti = ["Ana", "Mihai", "Ioana"];
async function main() {
for (const nume of clienti) {
console.log(`Notificare trimisa: ${nume}`);
await asteapta(setari.pauzaMs);
}
}
main();Notificare trimisa: Ana Notificare trimisa: Mihai Notificare trimisa: Ioana
Indiciu
Number(setari.pauzaMs) transformă "20" în 20.
Reparația
const fs = require("fs");
const { setTimeout: asteapta } = require("timers/promises");
const setari = JSON.parse(fs.readFileSync("setari.json", "utf8"));
const pauzaMs = Number(setari.pauzaMs);
const clienti = ["Ana", "Mihai", "Ioana"];
async function main() {
for (const nume of clienti) {
console.log(`Notificare trimisa: ${nume}`);
await asteapta(pauzaMs);
}
}
main();De ce merge
În setari.json, "20" e un string, iar setTimeout din timers/promises acceptă doar numere pentru delay. Number(setari.pauzaMs) face conversia o singură dată, la citirea setărilor, iar fiecare await asteapta(pauzaMs) așteaptă 20 ms înainte de notificarea următoare.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "delay" argument must be of type number. Received type string ('500')TypeError [ERR_INVALID_ARG_TYPE]: The "delay" argument must be of type number. Received undefinedTypeError [ERR_INVALID_ARG_TYPE]: The "delay" argument must be of type number. Received an instance of Object
Cum o eviți pe viitor
- Convertește variabilele de mediu și argumentele la citire, într-un singur loc (un modul
config.js). - În JSON, scrie numerele fără ghilimele.
- Verifică valoarea:
if (!Number.isFinite(pauza)) throw new Error("PAUZA_MS invalid"). - Ține minte că
setTimeoutclasic acceptă string-uri, dar cel dintimers/promisesnu.
Întrebări frecvente
De ce setTimeout(fn, "1000") merge, dar varianta cu await nu?
setTimeout clasic e păstrat compatibil cu codul vechi și convertește valoarea. Versiunea din timers/promises e mai nouă și validează strict tipul argumentelor.
Ce se întâmplă cu o valoare negativă sau NaN?
Nu primești eroare de tip: Node folosește 1 ms și afișează un warning (TimeoutNegativeWarning sau TimeoutNaNWarning). Tot e bine să validezi valoarea.
Erori înrudite
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. 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). 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. Î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.
