TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array. Received type string ('581ce21e4af9c83e5b8b...')
buf.equals() și Buffer.compare compară doar două Buffer-e, iar tu ai dat un text (de obicei un hash în hex sau base64). Transformă textul în Buffer cu Buffer.from(text, "hex"), sau compară două texte: hash.toString("hex") === asteptat.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
buf.equals(alt) întoarce true dacă două bufferuri au exact aceiași octeți, iar buf.compare(alt) și Buffer.compare(a, b) le ordonează. Toate cer ca al doilea operand să fie tot Buffer sau Uint8Array; un text nu e convertit automat, pentru că Node n-ar ști în ce codare e scris (utf8, hex, base64).
Mesajul apare tipic la verificarea unui hash sau a unei semnături: digest() fără argument întoarce un Buffer, iar valoarea așteptată, citită dintr-un fișier, dintr-un header sau din baza de date, e un text hex. Mesajul arată începutul textului primit.
Pentru comparații de hash-uri sau semnături HMAC, cea mai bună variantă e crypto.timingSafeEqual(a, b), tot cu două Buffer-e de aceeași lungime: compararea durează la fel indiferent unde diferă octeții, deci nu scurge informații prin timp.
De ce apare: cauzele frecvente
1Hash Buffer comparat cu text hex
const hash = crypto.createHash("sha256").update(date).digest();
if (hash.equals(asteptatHex)) { /* ... */ }const hash = crypto.createHash("sha256").update(date).digest();
if (hash.equals(Buffer.from(asteptatHex, "hex"))) { /* ... */ }Buffer.from(text, "hex") transformă cele 64 de caractere hex în cei 32 de octeți ai hash-ului, comparabili cu equals.
2Comparație simplă de texte
hash.equals(asteptatHex);crypto.createHash("sha256").update(date).digest("hex") === asteptatHex;Dacă ai deja valoarea așteptată ca text, cere și hash-ul ca text și compară-le direct.
3Semnătură verificată cu timingSafeEqual
crypto.timingSafeEqual(semnatura, req.headers["x-semnatura"]);const primita = Buffer.from(req.headers["x-semnatura"] || "", "hex");
const ok = primita.length === semnatura.length && crypto.timingSafeEqual(semnatura, primita);timingSafeEqual cere tot două bufferuri, de aceeași lungime; verifică lungimea înainte, ca să nu primești RangeError.
Repară eroarea, direct în pagină
Programul verifică integritatea fișierului raport.txt comparând hash-ul SHA-256 cu valoarea salvată, dar dă TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array, pentru că valoarea salvată e text hex. Transformă valoarea salvată în Buffer înainte de comparație, ca programul să confirme că fișierul e intact.
const crypto = require("crypto");
const fs = require("fs");
const asteptat = "581ce21e4af9c83e5b8b596812e6c5da54784986974fea5759d8da061060395e";
try {
const hash = crypto.createHash("sha256").update(fs.readFileSync("raport.txt")).digest();
console.log(hash.equals(asteptat) ? "Fișier intact" : "Fișier modificat");
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}Fișier intact
Indiciu
Buffer.from(asteptat, "hex") dă cei 32 de octeți ai hash-ului salvat.
Reparația
const crypto = require("crypto");
const fs = require("fs");
const asteptat = "581ce21e4af9c83e5b8b596812e6c5da54784986974fea5759d8da061060395e";
try {
const hash = crypto.createHash("sha256").update(fs.readFileSync("raport.txt")).digest();
console.log(hash.equals(Buffer.from(asteptat, "hex")) ? "Fișier intact" : "Fișier modificat");
} catch (err) {
console.error(err.message);
process.exitCode = 1;
}De ce merge
digest() fără argument întoarce hash-ul ca Buffer, iar equals acceptă doar un alt Buffer, nu un text. Buffer.from(asteptat, "hex") citește cele 64 de caractere hexazecimale ca 32 de octeți, exact forma lui hash, iar comparația se face octet cu octet. Alternativa echivalentă ar fi fost digest("hex") === asteptat.
Alte forme ale mesajului
TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array. Received undefinedTypeError [ERR_INVALID_ARG_TYPE]: The "target" argument must be an instance of Buffer or Uint8Array. Received type string ('abc')TypeError [ERR_INVALID_ARG_TYPE]: The "buf2" argument must be an instance of Buffer or Uint8Array. Received type string ('abc')
Cum o eviți pe viitor
- Hotărăște un singur format pentru hash-uri în cod: fie
Bufferpeste tot, fie text hex peste tot. - Convertește valorile venite din afară (headere, fișiere, baza de date) cu
Buffer.from(text, "hex")chiar la intrare. - Pentru secrete și semnături, folosește
crypto.timingSafeEqual, cu verificarea lungimii înainte.
Întrebări frecvente
Pot compara două Buffer-e cu ===?
Nu: === compară dacă sunt același obiect, nu dacă au aceiași octeți. Două bufferuri identice ca valoare dau false. Folosește equals sau timingSafeEqual.
De ce digest() fără argument dă Buffer?
Fără codare, rezultatul e forma brută a hash-ului: octeții lui. Cu digest("hex") sau digest("base64") primești direct textul în codarea respectivă.
Erori înrudite
RangeError [ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH]: Input buffers must have the same byte length crypto.timingSafeEqual(a, b) compară doar buffere de aceeași lungime și aruncă dacă lungimile diferă, de exemplu când semnătura primită e trunchiată sau lipsește. Verifică întâi a.length === b.length și tratează diferența ca „invalid”. Error: Digest method not supported Numele algoritmului dat lui crypto.createHash sau createHmac nu e recunoscut, de obicei o greșeală de scriere: "sha265" în loc de "sha256" sau "SHA-256" cu cratimă. Folosește un nume valid, de exemplu "sha256", "sha512" sau "md5". TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. Î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.
