error TS2556: A spread argument must either have a tuple type or be passed to a rest parameter.
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[]
function dist(x: number, y: number) { return Math.hypot(x, y); }
const p = [3, 4];
dist(...p);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ă
const parti = [2026, 10, 1];
const d = new Date(...parti);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
function suma(a: number, b: number) { return a + b; }
const note = [5, 7, 9];
suma(...note);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ă 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.
function distanta(x: number, y: number): number {
return Math.sqrt(x * x + y * y);
}
const punct = [3, 4];
console.log(`Distanța: ${distanta(...punct)}`);Distanța: 5
Indiciu
Adnotează punct cu [number, number].
Reparația
function distanta(x: number, y: number): number {
return Math.sqrt(x * x + y * y);
}
const punct: [number, number] = [3, 4];
console.log(`Distanța: ${distanta(...punct)}`);De ce merge
Fără adnotare, [3, 4] e dedus ca number[], un tablou de lungime necunoscută, deci TypeScript nu poate garanta că desfacerea dă exact cele două argumente cerute. Tipul tuplu [number, number] fixează lungimea la două, iar apelul devine echivalent cu distanta(3, 4). Rezultatul este radical din 9 + 16, adică 5.
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 canumber[], 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
error TS2554: Expected 2 arguments, but got 1. Ai apelat o funcție cu alt număr de argumente decât are parametri obligatorii. Trimite toate argumentele cerute sau, dacă unul chiar poate lipsi, fă parametrul opțional (nume?: tip) ori dă-i o valoare implicită. error TS2493: Tuple type '[string, number]' of length '2' has no element at index '2'. Citești dintr-un tuplu un element care nu există: tuplul are lungime fixă (aici 2, adică indicii 0 și 1) și ceri indicele 2. Folosește indicele corect sau adaugă elementul în tipul tuplului. error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'. Ai apelat o funcție cu un argument de alt tip decât cel declarat la parametru: funcția așteaptă number și primește string. Convertește valoarea înainte de apel (Number(...)) sau verifică dacă ai pus argumentele în ordinea corectă. Î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.
