[DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
Codul tău sau, mult mai des, un pachet din node_modules (tr46, whatwg-url, uri-js, versiuni vechi de node-fetch, ajv, eslint) încarcă modulul intern punycode, depreciat din Node 21. E doar un avertisment: actualizează pachetele; în codul tău folosește url.domainToASCII() sau new URL().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
punycode transformă domeniile cu caractere speciale în forma ASCII folosită de DNS (magazin-ș.ro → xn--...). Node a avut mult timp propriul modul punycode, dar l-a depreciat, iar din Node 21 afișează avertismentul la rulare când e încărcat.
Avertismentul nu oprește programul. Apare o singură dată, cu (node:PID) în față. De cele mai multe ori nu vine din codul tău, ci dintr-o dependență (de exemplu tr46 și whatwg-url, folosite de node-fetch@2, jsdom sau mongodb, ori uri-js folosit de ajv și eslint).
Ca să afli de unde vine, rulează node --trace-deprecation index.js: primești stiva de apeluri până la require("punycode"). Apoi npm ls tr46 sau npm ls uri-js îți arată ce pachet îl aduce.
De ce apare: cauzele frecvente
1Codul tău folosește punycode pentru domenii
const punycode = require("punycode");
console.log(punycode.toASCII("cafeneaua-ș.ro"));const { domainToASCII } = require("url");
console.log(domainToASCII("cafeneaua-ș.ro"));url.domainToASCII face aceeași conversie pentru domenii, fără modulul depreciat.
2O dependență veche
"dependencies": { "node-fetch": "^2.6.7" }// Node 18+ are fetch global: scoate node-fetch
const r = await fetch(url);Actualizarea sau eliminarea pachetului care aduce tr46 / whatwg-url vechi elimină avertismentul.
3Ai nevoie de funcțiile complete punycode
const punycode = require("punycode");// npm install punycode
const punycode = require("punycode/");Pachetul de pe npm cu același nume nu e depreciat. Slash-ul de la final forțează încărcarea lui din node_modules, nu a modulului intern.
Repară eroarea, direct în pagină
Funcția domeniuAscii transformă numele de domeniu cu diacritice în forma ASCII, dar folosește modulul intern punycode și primește [DEP0040] DeprecationWarning. Proiectul oprește programul la orice warning (primele rânduri). Fă aceeași conversie cu funcția din modulul url, ca programul să afișeze cele două domenii.
// 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 punycode = require("punycode");
function domeniuAscii(domeniu) {
return punycode.toASCII(domeniu);
}
console.log(domeniuAscii("cafea.ro"));
console.log(domeniuAscii("brânză.ro"));cafea.ro xn--brnz-coa4r.ro
Indiciu
require("url").domainToASCII(domeniu) întoarce forma xn--....
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 { domainToASCII } = require("url");
function domeniuAscii(domeniu) {
return domainToASCII(domeniu);
}
console.log(domeniuAscii("cafea.ro"));
console.log(domeniuAscii("brânză.ro"));De ce merge
Modulul intern punycode e depreciat, iar încărcarea lui emite DEP0040. url.domainToASCII face conversia IDNA a domeniilor: părțile cu diacritice devin xn--..., iar cele simple rămân neschimbate. E funcția pe care Node o folosește oricum intern pentru new URL().
Alte forme ale mesajului
(node:4120) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead. (Use `node --trace-deprecation ...` to show where the warning was created)DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.[DEP0040] DeprecationWarning: The `punycode` module is deprecated.
Cum o eviți pe viitor
- Rulează
npm outdatedși actualizează periodic dependențele. - Când apare un avertisment nou, folosește
node --trace-deprecationca să vezi de unde vine. - În codul tău, pentru domenii folosește
url.domainToASCII/url.domainToUnicodesaunew URL(...).hostname. - Nu ascunde avertismentele cu
--no-deprecationdecât temporar: ele anunță ce se va strica la următoarele versiuni.
Întrebări frecvente
E periculos? Aplicația mea se va opri?
Deocamdată nu: e doar un avertisment, iar modulul încă funcționează. Merită totuși rezolvat, pentru că într-o versiune viitoare modulul poate dispărea.
Am actualizat tot și tot apare. Ce fac?
Uneori pachetul principal e la zi, dar trage o versiune veche printr-o dependență. Poți forța o versiune nouă cu overrides în package.json sau poți aștepta o actualizare a pachetului. Între timp avertismentul e inofensiv.
Erori înrudite
[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. [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"). [DEP0176] DeprecationWarning: fs.F_OK is deprecated, use fs.constants.F_OK instead Constantele fs.F_OK, fs.R_OK, fs.W_OK și fs.X_OK, folosite cu fs.access, sunt depreciate la rulare din Node 24. Scrie fs.constants.F_OK (și restul la fel); valorile sunt aceleași, doar locul s-a schimbat. Î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.
