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

error TS2556: A spread argument must either have a tuple type or be passed to a rest parameter.

Pe scurt

Desfaci un tablou cu ...lista într-o funcție cu un număr fix de parametri. TypeScript nu știe câte elemente are tabloul; dă-i un tip tuplu ([number, number] sau as const) ori schimbă funcția să primească ...valori.

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

Ce înseamnă

Când scrii f(...lista), elementele tabloului devin argumente separate. Dacă f are exact doi parametri, TypeScript trebuie să fie sigur că lista are exact două elemente. Un tip number[] poate avea oricâte elemente (zero, unu, zece), deci compilatorul refuză apelul.

Mesajul îți dă cele două ieșiri: argumentul desfăcut să aibă tip tuplu (lungime fixă, de exemplu [number, number]), sau să fie trimis unui parametru rest (...valori: number[]), care acceptă orice număr de argumente.

Des întâlnit: coordonate ținute într-un tablou (const p = [10, 20] e dedus number[]), parametri trimiși mai departe dintr-o funcție în alta sau new Date(...parti). Math.max(...lista) nu dă eroarea, pentru că Math.max e declarată cu parametru rest.

De ce apare: cauzele frecvente

1Tablou dedus ca number[]

Greșit
TypeScript
function dist(x: number, y: number) { return Math.hypot(x, y); }
const p = [3, 4];
dist(...p);
Corect
TypeScript
function dist(x: number, y: number) { return Math.hypot(x, y); }
const p: [number, number] = [3, 4];
dist(...p);

Tipul tuplu garantează exact două numere, deci apelul e sigur.

2as const pe o valoare fixă

Greșit
TypeScript
const parti = [2026, 10, 1];
const d = new Date(...parti);
Corect
TypeScript
const parti = [2026, 10, 1] as const;
const d = new Date(...parti);

as const face din tablou un tuplu readonly cu lungime cunoscută.

3Funcția ar trebui să primească oricâte valori

Greșit
TypeScript
function suma(a: number, b: number) { return a + b; }
const note = [5, 7, 9];
suma(...note);
Corect
TypeScript
function suma(...valori: number[]) {
  return valori.reduce((s, v) => s + v, 0);
}
const note = [5, 7, 9];
suma(...note);

Cu parametru rest, orice tablou poate fi desfăcut în apel.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2556: A spread argument must either have a tuple type or be passed to a rest parameter. Dă variabilei punct un tip tuplu ca programul să compileze și să afișeze Distanța: 5.

Codul care dă eroarea
TypeScript
function distanta(x: number, y: number): number {
  return Math.sqrt(x * x + y * y);
}
const punct = [3, 4];
console.log(`Distanța: ${distanta(...punct)}`);
După reparație, programul afișează
Distanța: 5
Indiciu

Adnotează punct cu [number, number].

Cum o eviți pe viitor

  • Dacă o valoare are mereu un număr fix de elemente, declar-o ca tuplu sau cu as const.
  • Pentru funcții care primesc oricâte valori, folosește parametru rest.
  • Când trimiți argumente mai departe, tipează-le cu Parameters<typeof f>.
  • Ține minte că un literal [1, 2] fără adnotare e dedus ca number[], nu ca tuplu.

Întrebări frecvente

De ce Math.max(...lista) merge și funcția mea nu?

Math.max e declarată max(...values: number[]), deci are parametru rest. Funcția ta are parametri fixi, iar TypeScript nu poate garanta lungimea tabloului.

Ce face as const exact?

Transformă literalul în tipul cel mai precis: [2026, 10, 1] as const devine readonly [2026, 10, 1], un tuplu cu lungime și valori fixe. Așa poate fi desfăcut în parametri ficși.

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.