[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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Modulul util avea o serie de funcții de verificare a tipului (isArray, isString, isNumber, isDate și altele), scrise înainte ca JavaScript să aibă echivalente standard. Majoritatea au fost eliminate complet în Node 23. util.isArray a rămas deocamdată, dar afișează [DEP0044] la rulare, pentru că Array.isArray face exact același lucru.
Mesajul apare o singură dată per proces. Dacă stiva (cu node --trace-deprecation) arată un fișier din node_modules, pachetul respectiv folosește API-ul vechi; e un semn că pachetul e puțin întreținut și că, într-o versiune viitoare de Node, ar putea pica cu util.isArray is not a function.
Înlocuirea e unu la unu: util.isArray(x) devine Array.isArray(x), care merge și în browser.
De ce apare: cauzele frecvente
1Cod vechi care verifică tablouri
const util = require("util");
if (util.isArray(etichete)) { /* ... */ }if (Array.isArray(etichete)) { /* ... */ }Array.isArray e funcția standard, disponibilă global, fără require.
2Verificare cu instanceof Array
if (etichete instanceof Array) { /* ... */ }if (Array.isArray(etichete)) { /* ... */ }Nu e depreciat, dar instanceof greșește pentru tablouri create în alt context (de exemplu în vm sau în alt iframe). Array.isArray e corect mereu.
3Pachet care folosește util.isArray
(node:4120) [DEP0044] DeprecationWarning: The `util.isArray` API is deprecated.
// stiva arată node_modules/...npm ls nume-pachet
npm update nume-pachetActualizează pachetul; dacă nu mai e întreținut, caută o alternativă înainte să treci pe o versiune nouă de Node.
Repară eroarea, direct în pagină
Funcția normalizeazaEtichete acceptă etichetele unui produs fie ca tablou, fie ca text separat prin virgule. Ea folosește util.isArray, iar programul primește [DEP0044] DeprecationWarning: The util.isArray API is deprecated. Proiectul oprește programul la orice warning (primele rânduri). Folosește funcția standard, ca programul să afișeze etichetele ambelor produse.
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
const util = require("util");
function normalizeazaEtichete(etichete) {
const lista = util.isArray(etichete) ? etichete : etichete.split(",");
return lista.map((e) => e.trim().toLowerCase());
}
console.log(normalizeazaEtichete(["Cafea", " Boabe "]).join(" | "));
console.log(normalizeazaEtichete("Ceai, Verde, Bio").join(" | "));cafea | boabe ceai | verde | bio
Indiciu
Array.isArray(etichete) e disponibilă global, fără require("util").
Reparația
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
function normalizeazaEtichete(etichete) {
const lista = Array.isArray(etichete) ? etichete : etichete.split(",");
return lista.map((e) => e.trim().toLowerCase());
}
console.log(normalizeazaEtichete(["Cafea", " Boabe "]).join(" | "));
console.log(normalizeazaEtichete("Ceai, Verde, Bio").join(" | "));De ce merge
util.isArray e o funcție veche a lui Node, păstrată doar pentru compatibilitate și depreciată la rulare. Array.isArray face exact aceeași verificare, e parte din JavaScript și merge peste tot, deci nici nu mai ai nevoie de modulul util. Restul funcției rămâne neschimbat: tablourile trec direct, iar textul e împărțit după virgule.
Alte forme ale mesajului
(node:4120) [DEP0044] DeprecationWarning: The `util.isArray` API is deprecated. Please use `Array.isArray()` instead. (Use `node --trace-deprecation ...` to show where the warning was created)DeprecationWarning: The `util.isArray` API is deprecated. Please use `Array.isArray()` instead.TypeError: util.isArray is not a function
Cum o eviți pe viitor
- Folosește funcțiile standard:
Array.isArray,typeof x === "string",x instanceof Date,Number.isFinite. - Nu folosi funcțiile
util.is...; cele mai multe nu mai există în Node 23+. - Înainte să treci la o versiune nouă de Node, rulează testele cu
--throw-deprecation.
Întrebări frecvente
Va fi eliminat și util.isArray?
Probabil, ca și celelalte funcții util.is..., eliminate în Node 23. Deprecarea la rulare e ultimul pas înainte de eliminare.
Cum văd de unde vine un DeprecationWarning?
Pornește programul cu node --trace-deprecation index.js: warning-ul vine cu stiva de apeluri. Dacă linia e într-un fișier din node_modules, problema e într-un pachet, pe care îl actualizezi sau îl înlocuiești.
Erori înrudite
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. [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 }. [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead. Codul (al tău sau al unui pachet) creează bufferuri cu new Buffer(...) sau Buffer(...), formă depreciată de mult timp. Înlocuiește-o cu Buffer.from(text sau tablou) când ai date, și cu Buffer.alloc(n) când ai nevoie de un buffer gol de n octeți. Î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.
