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

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

Pe scurt

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

Greșit
JavaScript
const { query } = url.parse(link, true);
const categorie = query.categorie;
Corect
JavaScript
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

Greșit
JavaScript
const { pathname } = url.parse(req.url);
Corect
JavaScript
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

Greșit
JavaScript
(node:4120) [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized ...
// stiva arată node_modules/...
Corect
JavaScript
npm update
# sau caută o versiune nouă / un pachet alternativ

Dacă warning-ul vine dintr-o dependență, actualizarea ei e soluția; nu modifica fișierele din node_modules.

Repară tu

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.

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 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)}`);
După reparație, programul afișează
Cale: /produse
Categorie: cafea
Pagina: 2
Indiciu

const adresa = new URL(link), apoi adresa.pathname și adresa.searchParams.get("categorie").

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 și URLSearchParams, disponibile global în Node și în browser.
  • Pentru req.url din modulul http, construiește new URL(req.url, "http://localhost").
  • Tratează TypeError: Invalid URL pentru adresele venite de la utilizatori, cu try/catch sau cu URL.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

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