error TS1355: A 'const' assertion can only be applied to references to enum members, or string, number, boolean, array, or object literals.
Ai pus as const pe o variabilă sau pe rezultatul unei funcții. as const merge doar direct pe valoarea literală. Mută-l la declarare: const marimi = ['S', 'M', 'L'] as const.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
as const îi spune compilatorului să păstreze cel mai precis tip al unei valori scrise în cod: textele rămân tipuri literale ('S' în loc de string), tablourile devin tupluri readonly, obiectele primesc câmpuri readonly. Pentru asta trebuie să vadă valoarea literală chiar acolo unde e scris as const.
Dacă îl pui după o variabilă (marimi as const), după un apel de funcție (citeste() as const) sau după o expresie calculată, tipul a fost deja „lărgit” (la string[], de exemplu) și nu mai poate fi recuperat. TypeScript dă TS1355 și îți spune pe ce se poate aplica: membri de enum, texte, numere, booleeni, tablouri sau obiecte scrise literal.
Reparația e să muți as const la locul unde e scrisă valoarea, de obicei la declarație.
De ce apare: cauzele frecvente
1as const pe o variabilă
const marimi = ['S', 'M', 'L'];
const fixe = marimi as const;const marimi = ['S', 'M', 'L'] as const;La declarare, marimi a fost deja lărgit la string[]. Pus direct pe literal, as const dă readonly ['S', 'M', 'L'].
2as const pe rezultatul unei funcții
function rute() { return { acasa: '/', cos: '/cos' }; }
const r = rute() as const;function rute() {
return { acasa: '/', cos: '/cos' } as const;
}
const r = rute();Aserțiunea trebuie pusă pe obiectul literal din return, unde valoarea e încă vizibilă.
3as const pe o expresie calculată
const prefix = 'api';
const cale = (prefix + '/produse') as const;const prefix = 'api';
const cale = `${prefix}/produse` as const;Concatenarea cu + nu e un literal. Un template literal poate primi as const și dă tipul 'api/produse'.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS1355: A 'const' assertion can only be applied to references to enum members, or string, number, boolean, array, or object literals. Tipul Marime trebuie derivat din lista de mărimi. Repară codul ca programul să afișeze S/M/L și apoi M.
const marimi = ['S', 'M', 'L'];
const fixe = marimi as const;
type Marime = (typeof fixe)[number];
const aleasa: Marime = 'M';
console.log(fixe.join('/'));
console.log(aleasa);S/M/L M
Indiciu
as const trebuie pus acolo unde e scris tabloul, nu pe numele variabilei.
Reparația
const marimi = ['S', 'M', 'L'] as const;
const fixe = marimi;
type Marime = (typeof fixe)[number];
const aleasa: Marime = 'M';
console.log(fixe.join('/'));
console.log(aleasa);De ce merge
as const lucrează doar pe valoarea literală: pe variabila marimi, al cărei tip era deja string[], nu mai are ce păstra. Mutat la declarare, tabloul are tipul readonly ['S', 'M', 'L'], iar (typeof fixe)[number] dă uniunea 'S' | 'M' | 'L'. 'M' e o valoare permisă, iar programul afișează S/M/L și M.
Cum o eviți pe viitor
- Scrie
as constimediat după valoarea literală, la declarare, nu mai târziu. - Pentru liste de opțiuni folosește modelul
const X = [...] as const; type T = typeof X[number];. - Dacă vrei și verificare de tip, combină cu
satisfies:const cfg = {...} as const satisfies Config;. - Nu încerca să „îngheți” tipul unei valori deja calculate: tipează-o explicit cu o uniune de literale.
Întrebări frecvente
as const face valoarea imutabilă la rulare?
Nu. E doar o informație pentru compilator: câmpurile devin readonly în tip, deci TypeScript îți interzice modificarea. La rulare obiectul se poate schimba în continuare. Pentru imutabilitate reală folosește și Object.freeze.
De ce vreau as const pe o listă de opțiuni?
Ca să derivezi din ea un tip: const marimi = ['S', 'M', 'L'] as const; type Marime = typeof marimi[number]; dă 'S' | 'M' | 'L'. Fără as const, Marime ar fi doar string.
Erori înrudite
error TS4104: The type 'readonly number[]' is 'readonly' and cannot be assigned to the mutable type 'number[]'. Dai un tablou readonly unei variabile sau funcții care așteaptă un tablou modificabil (number[]). Marchează și parametrul ca readonly number[] sau lucrează pe o copie: [...lista]. error TS2322: Type '"XXL"' is not assignable to type 'Marime'. Tipul Marime acceptă doar câteva valori fixe (de exemplu "S" | "M" | "L"), iar tu ai pus una care nu e în listă. Folosește una dintre valorile permise sau, dacă valoarea e legitimă, adaug-o în uniune. error TS1360: Type '{}' does not satisfy the expected type 'Config'. Valoarea de lângă satisfies nu respectă tipul cerut: îi lipsește o proprietate obligatorie sau are o cheie în plus. Completează obiectul conform tipului; sub mesaj, TypeScript spune exact ce lipsește. Î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.
