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.
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...
if (util.isString(valoare)) return valoare.trim();
if (util.isNumber(valoare)) return String(valoare);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
util.isDate(d);
util.isError(e);
util.isNullOrUndefined(x);d instanceof Date;
e instanceof Error;
x === null || x === undefined; // sau x == nullFiecare funcție eliminată are un echivalent direct în limbaj.
3util.log pentru mesaje cu oră
util.log("Server pornit");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ă 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.
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;
}[Cafea] [42.00] [-]
Indiciu
typeof valoare === "string" și typeof valoare === "number".
Reparația
function curata(valoare) {
if (typeof valoare === "string") return valoare.trim();
if (typeof valoare === "number") 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;
}De ce merge
Funcțiile util.isString, util.isNumber și celelalte din familia util.is... au fost eliminate în Node 23, deci pe Node 24 util.isString e undefined. Operatorul typeof face aceeași verificare și face parte din limbaj, așa că funcționează în orice versiune de Node și în browser. null nu e nici text, nici număr, deci ajunge la ramura finală și devine -.
Alte forme ale mesajului
TypeError: util.isNumber is not a functionTypeError: util.isFunction is not a functionTypeError: util.isDate is not a functionTypeError: util.log is not a functionTypeError: 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
[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. [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 }. 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. Î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.
