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

TypeError: crypto.createCipher is not a function

Pe scurt

crypto.createCipher și crypto.createDecipher au fost eliminate în Node 22, după ani de depreciere (DEP0106), pentru că derivau cheia din parolă într-un mod nesigur. Folosește crypto.createCipheriv cu o cheie de 32 de octeți (de exemplu din crypto.scryptSync) și un IV aleator salvat lângă date.

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

Ce înseamnă

Mesajul pare o greșeală de scriere, dar e de fapt o funcție eliminată. createCipher(algoritm, parola) primea o parolă și deriva singur cheia și IV-ul cu o metodă veche (MD5, fără sare), deci același text dădea mereu același rezultat și parola se putea sparge ușor. A fost depreciată din Node 10 (DEP0106) și scoasă complet în Node 22.

Codul vechi, scris pentru Node 14-20, mergea cu un avertisment. După actualizarea la Node 22 sau 24, crypto.createCipher e undefined, iar apelul dă is not a function.

Înlocuirea e createCipheriv(algoritm, cheie, iv): cheia are lungimea exactă cerută de algoritm, iar IV-ul se generează aleator la fiecare criptare și se salvează împreună cu datele.

Atenție: datele criptate vechi cu createCipher nu se pot decripta direct cu createCipheriv și o cheie nouă. Ai nevoie de o migrare care reface cheia veche (EVP_BytesToKey).

De ce apare: cauzele frecvente

1Cod vechi de criptare

Greșit
JavaScript
const c = crypto.createCipher("aes-256-cbc", parola);
const criptat = c.update(text, "utf8", "hex") + c.final("hex");
Corect
JavaScript
const cheie = crypto.scryptSync(parola, "sare-aplicatie", 32);
const iv = crypto.randomBytes(16);
const c = crypto.createCipheriv("aes-256-cbc", cheie, iv);
const criptat = iv.toString("hex") + ":" + c.update(text, "utf8", "hex") + c.final("hex");

Cheia derivată cu scryptSync și IV-ul aleator, salvat în față, înlocuiesc derivarea veche și nesigură.

2Decriptarea veche

Greșit
JavaScript
const d = crypto.createDecipher("aes-256-cbc", parola);
Corect
JavaScript
const [ivHex, date] = criptat.split(":");
const d = crypto.createDecipheriv("aes-256-cbc", cheie, Buffer.from(ivHex, "hex"));

createDecipher a dispărut odată cu createCipher. Decriptarea nouă folosește aceeași cheie și IV-ul salvat.

3Pachet vechi care folosește createCipher

Greșit
JavaScript
"dependencies": { "cryptr": "^4.0.0" }
Corect
JavaScript
"dependencies": { "cryptr": "^6.3.0" }

Pachetele întreținute au trecut demult pe createCipheriv; actualizează-le înainte de a urca versiunea de Node.

Repară tu

Repară eroarea, direct în pagină

Modulul de criptare a fost scris pentru o versiune veche de Node și folosește crypto.createCipher / crypto.createDecipher, care nu mai există în Node 24. Rescrie cele două funcții cu createCipheriv / createDecipheriv, cu o cheie derivată din parolă și un IV aleator salvat în format iv:date, ca programul să afișeze textul decriptat.

Codul care dă eroarea
JavaScript
import crypto from "node:crypto";

const PAROLA = "Parola-Aplicatie";

function cripteaza(text) {
  const c = crypto.createCipher("aes-256-cbc", PAROLA);
  return c.update(text, "utf8", "hex") + c.final("hex");
}

function decripteaza(hex) {
  const d = crypto.createDecipher("aes-256-cbc", PAROLA);
  return d.update(hex, "hex", "utf8") + d.final("utf8");
}

console.log(decripteaza(cripteaza("IBAN RO49 AAAA 1B31 0075 9384 0000")));
După reparație, programul afișează
IBAN RO49 AAAA 1B31 0075 9384 0000
Indiciu

CHEIE = crypto.scryptSync(PAROLA, "sare-app", 32) și iv = crypto.randomBytes(16), iar IV-ul îl pui în fața datelor, în hex.

Alte forme ale mesajului

  • TypeError: crypto.createDecipher is not a function
  • (node:4120) [DEP0106] DeprecationWarning: crypto.createCipher is deprecated.
  • TypeError: (0 , crypto_1.createCipher) is not a function
  • TypeError: crypto.createCredentials is not a function

Cum o eviți pe viitor

  • Când urci versiunea de Node, citește lista de API-uri eliminate (în „Breaking changes” la fiecare versiune majoră).
  • Rulează proiectul cu avertismentele vizibile: DEP0106 apărea de ani buni înainte de eliminare.
  • Pentru criptare nouă, preferă aes-256-gcm, care verifică și integritatea datelor.
  • Păstrează parametrii (algoritm, sare, IV) într-un format versionat, ca să poți migra datele mai târziu.

Întrebări frecvente

Pot reveni la Node 20 ca să meargă?

Temporar, da, dar Node 20 nu mai e întreținut pe termen lung. E mai bine să treci la createCipheriv și să migrezi datele vechi o singură dată.

Cum decriptez datele criptate cu createCipher?

Trebuie refăcută cheia veche: createCipher folosea EVP_BytesToKey cu MD5 pe parolă. Există implementări mici (de exemplu pachetul evp_bytestokey) cu care obții cheia și IV-ul vechi, decriptezi cu createDecipheriv și recriptezi cu metoda nouă.

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.