...
Eroare Node.js · Asincron: callback-uri, promisiuni și timere

TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received undefined

Pe scurt

util.promisify() a primit undefined (sau altceva) în loc de o funcție cu callback: numele funcției e scris greșit (fs.readfile în loc de fs.readFile) sau funcția nu există în modul. Verifică numele; pentru fs folosește direct fs.promises sau node:fs/promises.

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

Ce înseamnă

util.promisify(original) transformă o funcție în stil callback (fs.readFile(cale, cb)) într-una care întoarce o promisiune, ca s-o poți folosi cu await. Parametrul se numește original și trebuie să fie o funcție.

Mesajul spune că a primit undefined, adică proprietatea pe care ai dat-o nu există: o literă mică în loc de una mare (fs.readfile), o funcție care nu e exportată de modul, sau o metodă scrisă fără obiectul ei. Eroarea apare chiar la apelul lui promisify, nu când folosești funcția rezultată.

Dacă după Received scrie an instance of Promise sau un rezultat, ai apelat deja funcția (promisify(fs.readFile("a.txt"))) în loc să o dai ca valoare.

De ce apare: cauzele frecvente

1Nume de funcție scris greșit

Greșit
JavaScript
const citeste = util.promisify(fs.readfile);
Corect
JavaScript
const citeste = util.promisify(fs.readFile);

Numele din Node sunt sensibile la majuscule: readFile, writeFile, readdir.

2Funcția apelată în loc să fie dată ca valoare

Greșit
JavaScript
const citeste = util.promisify(fs.readFile("note.txt"));
Corect
JavaScript
const citeste = util.promisify(fs.readFile);
const text = await citeste("note.txt", "utf8");

promisify primește funcția, iar argumentele le dai abia funcției rezultate.

3Nu ai nevoie de promisify pentru fs

Greșit
JavaScript
const citeste = util.promisify(fs.readFile);
Corect
JavaScript
const fs = require("fs/promises");
const text = await fs.readFile("note.txt", "utf8");

fs/promises are deja toate funcțiile în varianta cu promisiuni. promisify rămâne util pentru biblioteci vechi care au doar callback-uri.

Repară tu

Repară eroarea, direct în pagină

Programul transformă fs.readFile într-o funcție cu promisiuni cu util.promisify, dar numele funcției e scris greșit, așa că primește TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received undefined. Corectează numele, ca programul să afișeze câte produse are catalogul și cel mai scump produs.

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

const citeste = util.promisify(fs.readfile);

async function main() {
  const produse = JSON.parse(await citeste("catalog.json", "utf8"));
  const scump = produse.reduce((a, b) => (b.pret > a.pret ? b : a));
  console.log(`Produse: ${produse.length}`);
  console.log(`Cel mai scump: ${scump.nume} (${scump.pret} lei)`);
}

main();
După reparație, programul afișează
Produse: 3
Cel mai scump: Monitor (800 lei)
Indiciu

În Node funcția se scrie readFile, cu F mare.

Alte forme ale mesajului

  • TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received an instance of Promise
  • TypeError [ERR_INVALID_ARG_TYPE]: The "original" argument must be of type function. Received type string ('note.txt')
  • TypeError: The "original" argument must be of type Function

Cum o eviți pe viitor

  • Pentru fișiere, timere și readline folosește variantele gata cu promisiuni: fs/promises, timers/promises, readline/promises.
  • Lasă editorul să completeze numele funcțiilor, ca să eviți greșelile de majuscule.
  • Dă funcția fără paranteze: promisify(fs.readFile), nu promisify(fs.readFile(...)).
  • Pentru metode care folosesc this, leagă obiectul: promisify(client.get).bind(client).

Întrebări frecvente

Ce face exact util.promisify?

Întoarce o funcție nouă care apelează funcția originală cu un callback adăugat la final. Callback-ul rezolvă promisiunea cu rezultatul sau o respinge cu eroarea.

Merge cu orice funcție?

Doar cu funcții în stil Node: callback-ul e ultimul argument și primește întâi eroarea, (err, rezultat). Altfel promisiunea nu se comportă cum te aștepți.

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.