[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 }.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
util._extend copia proprietățile proprii ale unui obiect în altul, în vremea în care JavaScript nu avea Object.assign. Liniuța de jos din nume arăta că e o funcție internă, dar multe pachete au folosit-o oricum. Din Node 22, folosirea ei afișează la rulare [DEP0060].
Warning-ul vine fie din codul tău, fie, mai des, dintr-un pachet vechi (de exemplu servere de dezvoltare, unelte de proxy, bundlere vechi). În al doilea caz, stiva arată un fișier din node_modules; repararea e actualizarea pachetului.
Echivalentul direct e Object.assign(tinta, sursa), care modifică tinta. De cele mai multe ori vrei însă un obiect nou, fără să atingi valorile implicite: { ...implicit, ...setari } sau Object.assign({}, implicit, setari). Atenție: toate aceste variante copiază doar primul nivel; obiectele imbricate rămân partajate.
De ce apare: cauzele frecvente
1Combinarea setărilor cu valorile implicite
const config = util._extend(implicit, setari);const config = { ...implicit, ...setari };Sintaxa spread creează un obiect nou, iar valorile din setari le înlocuiesc pe cele implicite.
2Valorile implicite modificate din greșeală
util._extend(implicit, setariUtilizator);
// implicit e acum modificat pentru toată aplicațiaconst config = Object.assign({}, implicit, setariUtilizator);_extend (ca și Object.assign(tinta, ...)) scrie în primul obiect. Cu {} ca țintă, valorile implicite rămân neatinse.
3Warning din dependențe
(node:4120) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated.
// stiva arată node_modules/http-proxy/...npm ls http-proxy
npm updateAfli ce pachet aduce dependența și îl actualizezi; până atunci warning-ul e inofensiv.
Repară eroarea, direct în pagină
Scriptul combină setările implicite ale magazinului cu cele alese de utilizator folosind util._extend și primește [DEP0060] DeprecationWarning: The util._extend API is deprecated. Proiectul oprește programul la orice warning (primele rânduri). Combină setările fără util._extend și fără să modifici obiectul implicit, ca scriptul să afișeze configurația finală și valorile implicite neschimbate.
// 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");
const implicit = { moneda: "lei", tva: 0.21, limba: "ro" };
const setari = { limba: "en" };
const config = util._extend(implicit, setari);
console.log(`Config: ${JSON.stringify(config)}`);
console.log(`Implicit: ${JSON.stringify(implicit)}`);Config: {"moneda":"lei","tva":0.21,"limba":"en"}
Implicit: {"moneda":"lei","tva":0.21,"limba":"ro"}Indiciu
{ ...implicit, ...setari } creează un obiect nou în care valorile din setari le înlocuiesc pe cele implicite.
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;
});
const implicit = { moneda: "lei", tva: 0.21, limba: "ro" };
const setari = { limba: "en" };
const config = { ...implicit, ...setari };
console.log(`Config: ${JSON.stringify(config)}`);
console.log(`Implicit: ${JSON.stringify(implicit)}`);De ce merge
util._extend e o funcție internă veche, depreciată în favoarea mecanismelor standard din JavaScript. În plus, ea scria direct în primul obiect, deci implicit ajungea cu limba en pentru toată aplicația. Sintaxa spread creează un obiect nou: întâi copiază valorile implicite, apoi le suprascrie cu cele din setari, iar implicit rămâne neschimbat.
Alte forme ale mesajului
(node:4120) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead. (Use `node --trace-deprecation ...` to show where the warning was created)DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead.TypeError: util._extend is not a function
Cum o eviți pe viitor
- Nu folosi funcțiile din
utilcare încep cu_: sunt interne și pot dispărea. - Pentru combinarea obiectelor, folosește spread (
{ ...a, ...b }); pentru copii complete,structuredClone(obj). - Rulează periodic
npm outdatedși actualizează pachetele vechi care aduc astfel de warning-uri.
Întrebări frecvente
Care e diferența dintre spread și Object.assign?
Ca rezultat, aproape niciuna pentru obiecte simple. Object.assign(tinta, ...) modifică ținta și apelează setter-ele ei, iar spread-ul creează întotdeauna un obiect nou.
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
[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. 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. TypeError: Cannot assign to read only property 'port' of object '[object Module]' Încerci să modifici o valoare importată dintr-un modul ES. Importurile sunt doar pentru citire: nu poți scrie setari.port = 8080. Fă o copie (const config = { ...setari, port: 8080 }) sau exportă din modul o funcție care schimbă valoarea. Î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.
