...
Eroare TypeScript · Uniuni, tipuri literale și never

error TS1355: A 'const' assertion can only be applied to references to enum members, or string, number, boolean, array, or object literals.

Pe scurt

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ă

Greșit
TypeScript
const marimi = ['S', 'M', 'L'];
const fixe = marimi as const;
Corect
TypeScript
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

Greșit
TypeScript
function rute() { return { acasa: '/', cos: '/cos' }; }
const r = rute() as const;
Corect
TypeScript
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ă

Greșit
TypeScript
const prefix = 'api';
const cale = (prefix + '/produse') as const;
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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);
După reparație, programul afișează
S/M/L
M
Indiciu

as const trebuie pus acolo unde e scris tabloul, nu pe numele variabilei.

Cum o eviți pe viitor

  • Scrie as const imediat 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

← 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.