...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

TypeError [ERR_INVALID_ARG_TYPE]: The "delay" argument must be of type number. Received type string ('1000')

Pe scurt

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

Greșit
JavaScript
const { setTimeout: asteapta } = require("timers/promises");
await asteapta(process.env.PAUZA_MS || 1000);
Corect
JavaScript
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

Greșit
JavaScript
// config.json: { "reincercare": "2000" }
await asteapta(config.reincercare);
Corect
JavaScript
// 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ă

Greșit
JavaScript
const [, , secunde] = process.argv;
await asteapta(secunde * 1000 + "");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
După reparație, programul afișează
Notificare trimisa: Ana
Notificare trimisa: Mihai
Notificare trimisa: Ioana
Indiciu

Number(setari.pauzaMs) transformă "20" în 20.

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 undefined
  • TypeError [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ă setTimeout clasic acceptă string-uri, dar cel din timers/promises nu.

Î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

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