...
Eroare TypeScript · Funcții, apeluri și async

error TS1163: A 'yield' expression is only allowed in a generator body.

Pe scurt

Folosești yield într-o funcție obișnuită. yield merge doar în generatori, adică funcții declarate cu steluță: function* numere() { yield 1; }. Adaugă * după function (sau înaintea numelui metodei).

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

Ce înseamnă

yield produce câte o valoare dintr-un generator și îi suspendă execuția până la cererea următoarei valori. Un generator se declară cu steluță: function* numere(), async function* citeste(), sau, ca metodă, *valori().

Dacă scrii yield într-o funcție fără steluță, într-o funcție săgeată (care nu poate fi generator) sau într-un callback din interiorul unui generator (de exemplu în forEach), compilatorul dă TS1163. Ultimul caz e cel mai înșelător: yield e în corpul callback-ului, nu direct în generator.

De multe ori vezi și o a doua eroare la locul de folosire, de exemplu TS2488 (Type 'void' must have a '[Symbol.iterator]()' method), pentru că fără steluță funcția nu mai întoarce un iterator. Repară întâi TS1163.

De ce apare: cauzele frecvente

1Lipsește steluța din declarație

Greșit
TypeScript
function numere(max: number) {
  for (let i = 1; i <= max; i++) yield i;
}
Corect
TypeScript
function* numere(max: number) {
  for (let i = 1; i <= max; i++) yield i;
}

Doar function* creează un generator. Fără steluță, yield nu are sens în corpul funcției.

2yield într-un callback din generator

Greșit
TypeScript
function* dubleaza(xs: number[]) {
  xs.forEach((x) => {
    yield x * 2;
  });
}
Corect
TypeScript
function* dubleaza(xs: number[]) {
  for (const x of xs) {
    yield x * 2;
  }
}

Callback-ul din forEach e o funcție separată, nu generator. Cu for...of, yield stă direct în corpul generatorului.

3Metodă de clasă fără steluță

Greșit
TypeScript
class Stiva {
  private xs = [1, 2, 3];
  valori() {
    for (const x of this.xs) yield x;
  }
}
Corect
TypeScript
class Stiva {
  private xs = [1, 2, 3];
  *valori() {
    for (const x of this.xs) yield x;
  }
}

La metode, steluța stă înaintea numelui: *valori().

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1163: A 'yield' expression is only allowed in a generator body. Funcția numere trebuie să producă pe rând numerele de la 1 la max. Repar-o ca programul să afișeze 1 2 3 și apoi 1 2 3 4 5.

Codul care dă eroarea
TypeScript
function numere(max: number) {
  for (let i = 1; i <= max; i++) {
    yield i;
  }
}

console.log([...numere(3)].join(' '));
console.log([...numere(5)].join(' '));
După reparație, programul afișează
1 2 3
1 2 3 4 5
Indiciu

O funcție care folosește yield se declară cu un caracter în plus după function.

Cum o eviți pe viitor

  • Pune steluța din prima: function* sau *metoda() de îndată ce vrei să folosești yield.
  • În generatori, parcurge tablourile cu for...of, nu cu forEach / map.
  • Funcțiile săgeată nu pot fi generatori: dacă ai nevoie de yield, folosește function*.
  • Dacă vrei doar o listă de valori, un tablou simplu (map, filter) e adesea mai clar decât un generator.

Întrebări frecvente

Pot face o funcție săgeată generator?

Nu, JavaScript nu are sintaxă pentru generator săgeată. Folosește function* sau o metodă *nume().

Am pus yield într-un forEach dintr-un generator. De ce nu merge?

Pentru că funcția trimisă la forEach e o funcție separată, obișnuită. yield trebuie să fie direct în corpul generatorului: înlocuiește forEach cu for...of.

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.