...
Eroare Node.js · Buffer, crypto și assert

TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received undefined

Pe scurt

crypto.pbkdf2 / pbkdf2Sync cer ca ultim argument algoritmul de hash (de exemplu "sha512"), iar tu l-ai omis, cum se făcea în tutorialele vechi. Adaugă-l: crypto.pbkdf2Sync(parola, sare, 100000, 64, "sha512").

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

Ce înseamnă

crypto.pbkdf2Sync(parola, sare, iteratii, lungime, digest) derivă o cheie sau un hash de parolă. Ultimul argument, digest, spune ce funcție de hash folosește intern ("sha256", "sha512").

În versiunile foarte vechi de Node, digest era opțional și implicit sha1. Din Node 8 a devenit obligatoriu, dar multe tutoriale și răspunsuri vechi încă îl omit. Fără el, Node aruncă The "digest" argument must be of type string. Received undefined.

Aceeași eroare apare dacă argumentele sunt puse în altă ordine (de exemplu digest pus pe locul lungimii) sau dacă algoritmul e citit dintr-o configurație care lipsește. La varianta asincronă crypto.pbkdf2(..., digest, callback), dacă uiți digest, callback-ul ajunge pe locul lui și primești tot o eroare de tip.

De ce apare: cauzele frecvente

1Exemplu vechi fără algoritm

Greșit
JavaScript
const hash = crypto.pbkdf2Sync(parola, sare, 100000, 64);
Corect
JavaScript
const hash = crypto.pbkdf2Sync(parola, sare, 100000, 64, "sha512");

Algoritmul de hash e obligatoriu în versiunile actuale de Node.

2Varianta cu callback

Greșit
JavaScript
crypto.pbkdf2(parola, sare, 100000, 64, (err, cheie) => { ... });
Corect
JavaScript
crypto.pbkdf2(parola, sare, 100000, 64, "sha512", (err, cheie) => { ... });

Callback-ul vine după digest. Fără digest, funcția primește callback-ul în locul lui.

3Algoritm citit dintr-o configurație lipsă

Greșit
JavaScript
crypto.pbkdf2Sync(parola, sare, 100000, 64, config.algoritm); // undefined
Corect
JavaScript
crypto.pbkdf2Sync(parola, sare, 100000, 64, config.algoritm ?? "sha512");

O valoare implicită clară evită undefined când lipsește setarea.

Repară tu

Repară eroarea, direct în pagină

Funcția hashParola, copiată dintr-un tutorial vechi, apelează crypto.pbkdf2Sync fără algoritmul de hash și primește The "digest" argument must be of type string. Adaugă algoritmul sha512, ca programul să afișeze lungimea hash-ului și rezultatul verificării celor două parole.

Codul care dă eroarea
JavaScript
const crypto = require("crypto");

const SARE = "sare-utilizator-17";

function hashParola(parola) {
  return crypto.pbkdf2Sync(parola, SARE, 1000, 32).toString("hex");
}

const salvat = hashParola("Primavara2024!");
console.log(`Lungime hash: ${salvat.length}`);
console.log(`Parola corecta: ${hashParola("Primavara2024!") === salvat}`);
console.log(`Parola gresita: ${hashParola("primavara2024") === salvat}`);
După reparație, programul afișează
Lungime hash: 64
Parola corecta: true
Parola gresita: false
Indiciu

Algoritmul e al cincilea argument: crypto.pbkdf2Sync(parola, sare, 1000, 32, "sha512").

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received type number (64)
  • TypeError [ERR_INVALID_ARG_TYPE]: The "digest" argument must be of type string. Received function
  • TypeError [ERR_INVALID_ARG_TYPE]: The "keylen" argument must be of type number. Received undefined
  • TypeError [ERR_CRYPTO_INVALID_DIGEST]: Invalid digest: sha-512

Cum o eviți pe viitor

  • Scrie apelurile complet: pbkdf2Sync(parola, sare, iteratii, lungime, "sha512").
  • Pentru parole noi poți folosi crypto.scryptSync(parola, sare, 64), care nu cere algoritm separat.
  • Pune parametrii (iterații, lungime, algoritm) în constante cu nume, ca să-i folosești la fel la salvare și la verificare.
  • Verifică data exemplelor pe care le copiezi: cele dinainte de Node 8 omit digest.

Întrebări frecvente

Ce algoritm să aleg?

sha512 sau sha256 sunt alegeri standard. Important e să folosești același algoritm (și același număr de iterații) la crearea hash-ului și la verificarea parolei.

Câte iterații să pun?

Pentru parole, recomandările actuale pentru PBKDF2-SHA512 sunt de ordinul sutelor de mii. Cu cât sunt mai multe, cu atât e mai greu de spart, dar și mai lent la autentificare.

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.