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

TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array. Received type string ('581ce21e4af9c83e5b8b...')

Pe scurt

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

Greșit
JavaScript
const hash = crypto.createHash("sha256").update(date).digest();
if (hash.equals(asteptatHex)) { /* ... */ }
Corect
JavaScript
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

Greșit
JavaScript
hash.equals(asteptatHex);
Corect
JavaScript
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

Greșit
JavaScript
crypto.timingSafeEqual(semnatura, req.headers["x-semnatura"]);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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;
}
După reparație, programul afișează
Fișier intact
Indiciu

Buffer.from(asteptat, "hex") dă cei 32 de octeți ai hash-ului salvat.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "otherBuffer" argument must be an instance of Buffer or Uint8Array. Received undefined
  • TypeError [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 Buffer peste 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

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