...
Eroare TypeScript · Obiecte, interfețe și proprietăți

error TS2488: Type 'number' must have a '[Symbol.iterator]()' method that returns an iterator.

Pe scurt

Folosești for...of, spread [...x] sau destructurare [a, b] = x pe ceva care nu e iterabil: un număr sau un obiect simplu. Pentru obiecte folosește Object.entries / Object.values; pentru un număr de pași folosește un for clasic.

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

Ce înseamnă

for...of, operatorul spread în tablouri ([...x]) și destructurarea cu paranteze pătrate (const [a, b] = x) funcționează doar pe valori iterabile: tablouri, stringuri, Map, Set și alte obiecte care au metoda specială [Symbol.iterator](). Mesajul îți spune că tipul numit (aici number) nu are această metodă.

Cazurile tipice: vrei să repeți ceva de n ori și scrii for (const i of n); vrei să parcurgi un obiect sau un Record (for (const x of stocuri)), dar obiectele simple nu sunt iterabile; sau destructurezi un obiect cu [ ] în loc de { }.

La rulare, JavaScript ar arunca TypeError: n is not iterable; TypeScript o prinde la compilare.

De ce apare: cauzele frecvente

1for...of pe un număr

Greșit
TypeScript
const n = 3;
for (const i of n) {
  console.log(i);
}
Corect
TypeScript
const n = 3;
for (let i = 0; i < n; i++) {
  console.log(i);
}

Un număr nu are elemente; pentru repetări folosești un for clasic.

2for...of pe un obiect

Greșit
TypeScript
const stoc: Record<string, number> = { mere: 5, pere: 2 };
for (const x of stoc) {}
Corect
TypeScript
const stoc: Record<string, number> = { mere: 5, pere: 2 };
for (const [fruct, buc] of Object.entries(stoc)) {}

Object.entries întoarce un tablou de perechi, care e iterabil.

3Destructurare cu paranteze greșite

Greșit
TypeScript
const punct = { x: 1, y: 2 };
const [x, y] = punct;
Corect
TypeScript
const punct = { x: 1, y: 2 };
const { x, y } = punct;

Obiectele se destructurează după nume, cu acolade.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2488: Type 'Record<string, number>' must have a '[Symbol.iterator]()' method. Parcurge corect obiectul stoc ca programul să afișeze mere: 5, pere: 2 și Total: 7, fiecare pe câte o linie.

Codul care dă eroarea
TypeScript
const stoc: Record<string, number> = { mere: 5, pere: 2 };
let total = 0;
for (const [fruct, buc] of stoc) {
  console.log(`${fruct}: ${buc}`);
  total += buc;
}
console.log(`Total: ${total}`);
După reparație, programul afișează
mere: 5
pere: 2
Total: 7
Indiciu

Parcurge Object.entries(stoc) și destructurează fiecare pereche în [fruct, buc].

Alte forme ale mesajului

  • error TS2488: Type 'Record<string, number>' must have a '[Symbol.iterator]()' method that returns an iterator.
  • error TS2488: Type '{ x: number; y: number; }' must have a '[Symbol.iterator]()' method that returns an iterator.

Cum o eviți pe viitor

  • Folosește for...of doar pe tablouri, stringuri, Map și Set.
  • Pentru obiecte, alege Object.keys, Object.values sau Object.entries, după ce îți trebuie.
  • Când ai nevoie de perechi cheie-valoare iterabile, ia în calcul un Map.
  • Ține minte: [ ] destructurează după poziție (tablouri), { } după nume (obiecte).

Întrebări frecvente

E același lucru cu „x is not iterable” din JavaScript?

Da, e aceeași problemă. TypeError: x is not iterable apare la rulare în JavaScript, iar TS2488 o anunță dinainte, la compilare.

De ce for...in merge pe obiecte?

for...in parcurge numele proprietăților unui obiect, nu valorile, și nu are nevoie de iterator. În TypeScript cheia e de tip string, deci pentru valori tipate e mai comod Object.entries.

Erori înrudite

← Toate erorile TypeScript

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ță TypeScript de la zero, cu exerciții la fiecare lecție

Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.