[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.
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
const cod = new Buffer(`${user}:${cheie}`).toString("base64");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
const bloc = new Buffer(1024);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
(node:4120) [DEP0005] DeprecationWarning: Buffer() is deprecated ...
// stiva arată node_modules/pachet-vechi/index.jsnpm ls pachet-vechi
npm install pachet-vechi@latest
# sau înlocuiește pachetul cu unul întreținutWarning-ul vine din codul pachetului; versiunile noi au trecut aproape toate la Buffer.from și Buffer.alloc.
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.
// 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)}`);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).
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 user = "api";
const cheie = "cheie-test";
const credentiale = Buffer.from(`${user}:${cheie}`).toString("base64");
console.log(`Authorization: Basic ${credentiale}`);
const bloc = Buffer.alloc(16);
console.log(`Bloc pregătit: ${bloc.length} octeți, toți zero: ${bloc.every((b) => b === 0)}`);De ce merge
Constructorul Buffer() e depreciat pentru că același apel însemna lucruri diferite: cu text copia datele, cu un număr aloca memorie neinițializată. Buffer.from acceptă doar date (text, tablou, alt buffer), iar Buffer.alloc(16) creează exact 16 octeți setați la zero, deci fără resturi din memorie. Rezultatul e același, dar codul e explicit și nu mai declanșează DEP0005.
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(...)sauBuffer(...)î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.allocUnsafedoar dacă scrii imediat peste toți octeții; altfel rămâi laBuffer.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
TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. TypeError [ERR_INVALID_ARG_TYPE]: The "size" argument must be of type number. Received type string ('16') Buffer.alloc, Buffer.allocUnsafe și crypto.randomBytes primesc dimensiunea ca număr, iar tu ai dat un text (de obicei citit din process.env, dintr-un JSON sau din query string). Convertește valoarea cu Number(...) sau parseInt(..., 10) și verifică să fie un întreg pozitiv. [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead. CVEs are not issued for `url.parse()` vulnerabilities. url.parse() e vechiul parser de adrese al lui Node, care tratează unele URL-uri altfel decât browserele și poate fi păcălit. Folosește new URL(adresa) și url.searchParams.get("cheie"); pentru adrese relative, dă și o bază: new URL(req.url, "http://localhost"). Î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.
