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

[DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Constructorul Buffer() făcea lucruri diferite după tipul argumentului: new Buffer("abc") copia textul, iar new Buffer(10) aloca 10 octeți neinițializați, care puteau conține date vechi din memorie (parole, chei). Un număr ajuns din greșeală acolo (de exemplu din JSON) putea expune memoria procesului. De aceea Node l-a înlocuit cu funcții separate, explicite.

Warning-ul [DEP0005] apare o singură dată per proces și doar pentru codul din afara node_modules; programul continuă să ruleze. Dacă rulezi cu --throw-deprecation sau proiectul tratează warning-urile ca erori (în teste, în CI), devine o eroare care oprește execuția.

Înlocuirile sunt directe: Buffer.from(...) pentru texte, tablouri sau alte bufferuri, Buffer.alloc(n) pentru n octeți setați la zero și, doar dacă știi sigur că vei scrie peste toți, Buffer.allocUnsafe(n), mai rapid.

De ce apare: cauzele frecvente

1Buffer creat dintr-un text

Greșit
JavaScript
const cod = new Buffer(`${user}:${cheie}`).toString("base64");
Corect
JavaScript
const cod = Buffer.from(`${user}:${cheie}`).toString("base64");

Buffer.from face același lucru, fără ambiguitate între „date” și „dimensiune”.

2Buffer gol de o anumită dimensiune

Greșit
JavaScript
const bloc = new Buffer(1024);
Corect
JavaScript
const bloc = Buffer.alloc(1024);

Buffer.alloc umple bufferul cu zero, deci nu poate conține resturi din memoria procesului.

3Pachet vechi din node_modules

Greșit
JavaScript
(node:4120) [DEP0005] DeprecationWarning: Buffer() is deprecated ...
// stiva arată node_modules/pachet-vechi/index.js
Corect
JavaScript
npm ls pachet-vechi
npm install pachet-vechi@latest
# sau înlocuiește pachetul cu unul întreținut

Warning-ul vine din codul pachetului; versiunile noi au trecut aproape toate la Buffer.from și Buffer.alloc.

Repară tu

Repară eroarea, direct în pagină

Scriptul construiește header-ul Authorization pentru un API și pregătește un buffer gol, dar folosește new Buffer(...) și primește [DEP0005] DeprecationWarning: Buffer() is deprecated. Proiectul oprește programul la orice warning (primele rânduri). Înlocuiește ambele apeluri cu funcțiile recomandate, ca scriptul să ruleze fără warning.

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 user = "api";
const cheie = "cheie-test";

const credentiale = new Buffer(`${user}:${cheie}`).toString("base64");
console.log(`Authorization: Basic ${credentiale}`);

const bloc = new Buffer(16);
console.log(`Bloc pregătit: ${bloc.length} octeți, toți zero: ${bloc.every((b) => b === 0)}`);
După reparație, programul afișează
Authorization: Basic YXBpOmNoZWllLXRlc3Q=
Bloc pregătit: 16 octeți, toți zero: true
Indiciu

Pentru text folosește Buffer.from(...), iar pentru 16 octeți goi Buffer.alloc(16).

Alte forme ale mesajului

  • (node:4120) [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead. (Use `node --trace-deprecation ...` to show where the warning was created)
  • DeprecationWarning: Buffer() is deprecated due to security and usability issues. Please use the Buffer.alloc(), Buffer.allocUnsafe(), or Buffer.from() methods instead.
  • [DEP0005] DeprecationWarning: Buffer() is deprecated due to security and usability issues.

Cum o eviți pe viitor

  • Nu folosi niciodată new Buffer(...) sau Buffer(...) în cod nou.
  • Caută în proiect new Buffer( și înlocuiește: date → Buffer.from, dimensiune → Buffer.alloc.
  • Rulează testele cu --throw-deprecation, ca să prinzi API-urile depreciate devreme.
  • Folosește Buffer.allocUnsafe doar dacă scrii imediat peste toți octeții; altfel rămâi la Buffer.alloc.

Întrebări frecvente

De ce warning-ul apare doar o dată?

Node afișează fiecare cod de deprecare o singură dată per proces, ca să nu umple logurile. Chiar dacă ai zeci de apeluri, vezi un singur mesaj; caută-le pe toate în cod.

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.