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

[DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead.

Pe scurt

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

Greșit
JavaScript
const config = util._extend(implicit, setari);
Corect
JavaScript
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ă

Greșit
JavaScript
util._extend(implicit, setariUtilizator);
// implicit e acum modificat pentru toată aplicația
Corect
JavaScript
const 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

Greșit
JavaScript
(node:4120) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated.
// stiva arată node_modules/http-proxy/...
Corect
JavaScript
npm ls http-proxy
npm update

Afli ce pachet aduce dependența și îl actualizezi; până atunci warning-ul e inofensiv.

Repară tu

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.

Codul care dă eroarea
JavaScript
// 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)}`);
După reparație, programul afișează
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.

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 util care î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

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