...
Eroare Node.js · Versiuni Node: API-uri depreciate și eliminate

TypeError: util.isString is not a function

Pe scurt

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.

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

Ce înseamnă

Aceste funcții existau din primele versiuni de Node, înainte ca JavaScript să aibă un mod clar de a verifica tipurile. Au fost depreciate în documentație ani la rând, apoi la rulare, iar în Node 23 au fost scoase complet. Codul care le folosește mergea perfect pe Node 18, 20 sau 22 și pică imediat după actualizarea la Node 23 sau 24.

Mesajul e cel obișnuit pentru o funcție inexistentă: util.isString e acum undefined. Dacă ai scris require("util").isString(...), mesajul arată require(...).isString is not a function.

Cel mai des eroarea vine dintr-un pachet vechi din node_modules (stiva îți arată fișierul). Verifică dacă există o versiune nouă; dacă pachetul nu mai e întreținut, înlocuiește-l, sau, temporar, rămâi pe Node 22 până faci migrarea. În codul tău, înlocuirile sunt simple: typeof, instanceof, Array.isArray, Number.isFinite, x === null || x === undefined.

De ce apare: cauzele frecvente

1Verificări de tip cu util.is...

Greșit
JavaScript
if (util.isString(valoare)) return valoare.trim();
if (util.isNumber(valoare)) return String(valoare);
Corect
JavaScript
if (typeof valoare === "string") return valoare.trim();
if (typeof valoare === "number") return String(valoare);

typeof e verificarea standard pentru tipurile primitive și merge în orice versiune de JavaScript.

2Date, erori și valori goale

Greșit
JavaScript
util.isDate(d);
util.isError(e);
util.isNullOrUndefined(x);
Corect
JavaScript
d instanceof Date;
e instanceof Error;
x === null || x === undefined; // sau x == null

Fiecare funcție eliminată are un echivalent direct în limbaj.

3util.log pentru mesaje cu oră

Greșit
JavaScript
util.log("Server pornit");
Corect
JavaScript
console.log(`${new Date().toISOString()} Server pornit`);

util.log adăuga ora în fața mesajului; o adaugi singur sau folosești o bibliotecă de logare.

Repară tu

Repară eroarea, direct în pagină

Funcția curata a fost scrisă pentru Node 18 și folosește util.isString și util.isNumber. Pe Node 24 programul dă TypeError: util.isString is not a function, pentru că funcțiile au fost eliminate în Node 23. Înlocuiește-le cu verificările standard, ca programul să afișeze valorile curățate.

Codul care dă eroarea
JavaScript
const util = require("util");

function curata(valoare) {
  if (util.isString(valoare)) return valoare.trim();
  if (util.isNumber(valoare)) return valoare.toFixed(2);
  return "-";
}

try {
  for (const v of ["  Cafea  ", 42, null]) {
    console.log(`[${curata(v)}]`);
  }
} catch (err) {
  console.error(`${err.name}: ${err.message}`);
  process.exitCode = 1;
}
După reparație, programul afișează
[Cafea]
[42.00]
[-]
Indiciu

typeof valoare === "string" și typeof valoare === "number".

Alte forme ale mesajului

  • TypeError: util.isNumber is not a function
  • TypeError: util.isFunction is not a function
  • TypeError: util.isDate is not a function
  • TypeError: util.log is not a function
  • TypeError: require(...).isString is not a function

Cum o eviți pe viitor

  • Citește lista de „breaking changes” înainte de o actualizare majoră de Node și rulează testele pe noua versiune în CI.
  • Rulează din când în când cu --throw-deprecation, ca să găsești API-urile care urmează să dispară.
  • Fixează versiunea de Node a proiectului în package.json ("engines") și în .nvmrc, ca toată echipa să ruleze aceeași versiune.

Întrebări frecvente

De ce pică după actualizarea la Node 24, fără nicio modificare în cod?

Funcțiile au fost eliminate în Node 23. Pe versiunile mai vechi existau (cu un warning de deprecare), deci același cod mergea.

Pot adăuga eu înapoi util.isString?

Tehnic poți scrie util.isString = (x) => typeof x === "string" la pornire, ca soluție temporară pentru un pachet vechi. E un plasture: rezolvarea reală e actualizarea sau înlocuirea pachetului.

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.