...
Eroare JavaScript · Tipuri greșite: funcții, tablouri, iterabile

TypeError: Bind must be called on a function

Pe scurt

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ă

Greșit
JavaScript
const leaga = (fn, ctx) => Function.prototype.bind.call(fn, ctx);
const afiseaza = leaga(cos.afiseazaTotal, cos);
Corect
JavaScript
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

Greșit
JavaScript
for (const cheie of Object.keys(cos)) {
  cos[cheie] = Function.prototype.bind.call(cos[cheie], cos);
}
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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();
După reparație, programul afișează
Coș: 2 produse
Indiciu

Leagă cos[cheie] doar dacă typeof cos[cheie] este "function".

Alte forme ale mesajului

  • TypeError: Function.prototype.bind called on incompatible undefined
  • TypeError: Bind must be called on a function at bind
  • TypeError: 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 de bind.
  • 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

← Toate erorile JavaScript

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ță 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.