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

[DEP0044] DeprecationWarning: The `util.isArray` API is deprecated. Please use `Array.isArray()` instead.

Pe scurt

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

Greșit
JavaScript
const util = require("util");
if (util.isArray(etichete)) { /* ... */ }
Corect
JavaScript
if (Array.isArray(etichete)) { /* ... */ }

Array.isArray e funcția standard, disponibilă global, fără require.

2Verificare cu instanceof Array

Greșit
JavaScript
if (etichete instanceof Array) { /* ... */ }
Corect
JavaScript
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

Greșit
JavaScript
(node:4120) [DEP0044] DeprecationWarning: The `util.isArray` API is deprecated.
// stiva arată node_modules/...
Corect
JavaScript
npm ls nume-pachet
npm update nume-pachet

Actualizează pachetul; dacă nu mai e întreținut, caută o alternativă înainte să treci pe o versiune nouă de Node.

Repară tu

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.

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");

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(" | "));
După reparație, programul afișează
cafea | boabe
ceai | verde | bio
Indiciu

Array.isArray(etichete) e disponibilă global, fără require("util").

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

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