TypeError: Bind must be called on a function
Codul a încercat să lege (bind) un this de ceva care nu e funcție, de obicei o metodă cu nume greșit sau inexistentă, trecută printr-un utilitar care folosește Function.prototype.bind.call. Verifică numele metodei și că valoarea e funcție.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fn.bind(obiect) creează o funcție nouă în care this e mereu obiect. Dacă scrii direct obj.metodaLipsa.bind(obj), primești Cannot read properties of undefined (reading 'bind'). Mesajul Bind must be called on a function apare când bind e apelat indirect, prin Function.prototype.bind.call(valoare, ...) sau Reflect.apply(Function.prototype.bind, valoare, ...), iar valoare nu e funcție.
Forma indirectă apare în utilitare generice (o funcție leaga(fn, ctx), autobind pentru toate metodele unei clase), în polyfill-uri și în biblioteci. Cauza practică e aproape mereu aceeași: numele metodei e scris greșit, metoda e o proprietate obișnuită (un număr, un text) sau obiectul nu are metoda respectivă.
Urmărește stiva de apeluri până la locul unde ai trimis valoarea către utilitar și verifică ce era ea de fapt.
De ce apare: cauzele frecvente
1Utilitar de legare primește o metodă inexistentă
const leaga = (fn, ctx) => Function.prototype.bind.call(fn, ctx);
const afiseaza = leaga(cos.afiseazaTotal, cos);const leaga = (fn, ctx) => Function.prototype.bind.call(fn, ctx);
const afiseaza = leaga(cos.afiseaza, cos);afiseazaTotal nu există pe obiect, deci utilitarul primește undefined. Cu numele corect primește funcția.
2Legarea tuturor proprietăților unui obiect
for (const cheie of Object.keys(cos)) {
cos[cheie] = Function.prototype.bind.call(cos[cheie], cos);
}for (const cheie of Object.keys(cos)) {
if (typeof cos[cheie] === "function") {
cos[cheie] = cos[cheie].bind(cos);
}
}Pe lângă metode, obiectul are și date (de exemplu produse). Doar funcțiile pot fi legate.
Repară eroarea, direct în pagină
Funcția legaMetodele leagă toate proprietățile coșului de obiectul cos, ca metodele să poată fi date ca callback, dar dă TypeError: Bind must be called on a function, pentru că una dintre proprietăți e un tablou. Repară funcția ca să lege doar metodele, iar programul să afișeze Coș: 2 produse.
const cos = {
produse: ["mouse", "cablu"],
afiseaza() {
console.log(`Coș: ${this.produse.length} produse`);
},
};
function legaMetodele(obiect) {
for (const cheie of Object.keys(obiect)) {
obiect[cheie] = Function.prototype.bind.call(obiect[cheie], obiect);
}
}
legaMetodele(cos);
const callback = cos.afiseaza;
callback();Coș: 2 produse
Indiciu
Leagă cos[cheie] doar dacă typeof cos[cheie] este "function".
Reparația
const cos = {
produse: ["mouse", "cablu"],
afiseaza() {
console.log(`Coș: ${this.produse.length} produse`);
},
};
function legaMetodele(obiect) {
for (const cheie of Object.keys(obiect)) {
if (typeof obiect[cheie] === "function") {
obiect[cheie] = Function.prototype.bind.call(obiect[cheie], obiect);
}
}
}
legaMetodele(cos);
const callback = cos.afiseaza;
callback();De ce merge
bind poate crea o funcție legată doar pornind de la o funcție. Prima cheie, produse, e un tablou, așa că apelul indirect eșuează. Cu verificarea typeof, funcția sare peste date și leagă doar afiseaza, care apoi poate fi apelată separat și păstrează this corect.
Alte forme ale mesajului
TypeError: Function.prototype.bind called on incompatible undefinedTypeError: Bind must be called on a function at bindTypeError: Cannot read properties of undefined (reading 'bind')
Cum o eviți pe viitor
- Verifică
typeof valoare === "function"în orice utilitar care leagă sau apelează funcții primite ca parametru. - În clase, preferă câmpuri cu arrow function (
afiseaza = () => {...}), care nu au nevoie debind. - La legarea automată a metodelor, parcurge doar funcțiile, nu toate cheile.
- Folosește autocompletarea editorului pentru numele metodelor.
Întrebări frecvente
De ce nu primesc direct „Cannot read properties of undefined (reading 'bind')”?
Acel mesaj apare când scrii obj.metoda.bind(...) și metoda lipsește. Aici bind e apelat cu .call, deci motorul ajunge în interiorul lui bind și abia acolo vede că valoarea nu e funcție.
Când chiar am nevoie de bind?
Când transmiți o metodă ca callback (la un eveniment, la setTimeout) și ea folosește this. Fără bind, this s-ar pierde.
Erori înrudite
TypeError: Function.prototype.apply was called on undefined, which is a undefined and not a function Codul a încercat să apeleze ceva care nu e funcție prin apply sau Reflect.apply, de obicei o funcție căutată după nume într-un obiect, care nu există. Verifică numele și că valoarea e funcție înainte de apel (typeof fn === "function"). TypeError: calculeazaTotal is not a function Apelezi cu `()` ceva care nu este o funcție: un număr, un text, un obiect sau `undefined`. De obicei numele metodei e scris greșit, ai suprascris funcția cu o variabilă cu același nume sau metoda nu există pe acel tip de valoare. Verifică ce conține de fapt numele din mesaj. TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
