[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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
url.parse() există din primele versiuni de Node, dinainte de standardul WHATWG URL folosit de browsere. Pentru unele adrese neobișnuite (caractere speciale, @, \, spații) dă alte rezultate decât browserul, ceea ce a dus la probleme de securitate: un filtru de domenii putea fi ocolit cu o adresă construită special. Node nu mai repară astfel de probleme în url.parse (nu emite CVE-uri pentru el) și recomandă API-ul standard, URL.
În Node 24, warning-ul [DEP0169] apare la rulare când codul din afara node_modules folosește url.parse(). Programul continuă, dar warning-ul e un semnal clar că trebuie să migrezi.
Diferențe practice la migrare: new URL() cere o adresă absolută (sau o bază ca al doilea argument), aruncă TypeError: Invalid URL pentru adrese invalide în loc să întoarcă ceva aproximativ, iar parametrii se citesc prin searchParams.get(...), nu dintr-un obiect query.
De ce apare: cauzele frecvente
1Parametrii din query string
const { query } = url.parse(link, true);
const categorie = query.categorie;const adresa = new URL(link);
const categorie = adresa.searchParams.get("categorie");searchParams citește parametrii după standard, decodând corect diacriticele și caracterele speciale.
2Adresa relativă din req.url
const { pathname } = url.parse(req.url);const { pathname } = new URL(req.url, "http://localhost");req.url e doar calea (/produse?p=2). new URL are nevoie de o bază ca să o interpreteze; domeniul bazei nu contează dacă folosești doar calea și parametrii.
3Pachet care folosește url.parse
(node:4120) [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized ...
// stiva arată node_modules/...npm update
# sau caută o versiune nouă / un pachet alternativDacă warning-ul vine dintr-o dependență, actualizarea ei e soluția; nu modifica fișierele din node_modules.
Repară eroarea, direct în pagină
Scriptul citește calea și parametrii dintr-un link de produs cu url.parse() și primește [DEP0169] DeprecationWarning: url.parse() behavior is not standardized. Proiectul oprește programul la orice warning (primele rânduri). Rescrie citirea cu API-ul standard URL, ca scriptul să afișeze calea, categoria și pagina.
// 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 url = require("url");
const link = "https://magazin.exemplu.ro/produse?categorie=cafea&pagina=2";
const adresa = url.parse(link, true);
console.log(`Cale: ${adresa.pathname}`);
console.log(`Categorie: ${adresa.query.categorie}`);
console.log(`Pagina: ${Number(adresa.query.pagina)}`);Cale: /produse Categorie: cafea Pagina: 2
Indiciu
const adresa = new URL(link), apoi adresa.pathname și adresa.searchParams.get("categorie").
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 link = "https://magazin.exemplu.ro/produse?categorie=cafea&pagina=2";
const adresa = new URL(link);
console.log(`Cale: ${adresa.pathname}`);
console.log(`Categorie: ${adresa.searchParams.get("categorie")}`);
console.log(`Pagina: ${Number(adresa.searchParams.get("pagina"))}`);De ce merge
url.parse e parserul vechi, nestandard, al lui Node, depreciat din cauza diferențelor de interpretare față de browsere. new URL(link) folosește standardul WHATWG: pathname dă calea, iar searchParams.get(...) dă valoarea fiecărui parametru, ca text (de aceea Number(...) pentru pagină). URL e global, deci nici nu mai ai nevoie de require("url").
Alte forme ale mesajului
(node:4120) [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. (Use `node --trace-deprecation ...` to show where the warning was created)DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead.[DEP0116] DeprecationWarning: The `url.format()` with a legacy object is deprecated
Cum o eviți pe viitor
- În cod nou folosește doar
URLșiURLSearchParams, disponibile global în Node și în browser. - Pentru
req.urldin modululhttp, construieștenew URL(req.url, "http://localhost"). - Tratează
TypeError: Invalid URLpentru adresele venite de la utilizatori, cutry/catchsau cuURL.canParse(adresa).
Întrebări frecvente
url.parse a fost eliminat?
Nu încă, funcționează în continuare. E însă depreciat la rulare, iar Node recomandă clar trecerea la URL, pentru că problemele lui de securitate nu mai sunt reparate.
Ce face al doilea argument true din url.parse(link, true)?
Transformă query string-ul într-un obiect. Echivalentul modern e Object.fromEntries(new URL(link).searchParams) sau, pentru un singur parametru, searchParams.get("nume").
Erori înrudite
TypeError: Invalid URL new URL() a primit un text care nu e o adresă completă, de obicei o cale relativă ca req.url ("/produse?pagina=2"), fără protocol și domeniu. Dă-i și o bază: new URL(req.url, "http://localhost"). În eroare, câmpul input arată exact textul primit. TypeError: parametri.hasOwnProperty is not a function Obiectul întors de querystring.parse() (și alte obiecte create cu Object.create(null)) nu are prototip, deci nu are metoda hasOwnProperty. Folosește Object.hasOwn(parametri, "cheie") sau "cheie" in parametri. [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. Î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.
