error TS2339: Property 'length' does not exist on type 'never'.
TypeScript a ajuns la concluzia că în acel loc variabila nu poate avea nicio valoare (tipul never), de obicei după ce toate cazurile unei uniuni au fost deja tratate, sau pentru că un tablou gol [] a fost dedus ca never[]. Verifică logica condițiilor sau dă un tip explicit tabloului.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
never e tipul fără nicio valoare. TypeScript ajunge la el prin restrângere: dacă x e 'card' | 'cash' și ai tratat ambele cazuri cu if, în ramura else nu mai rămâne nimic, deci x e never. Orice proprietate citită acolo dă TS2339 pe never.
Două situații frecvente:
- Condiții care se exclud: verifici
typeof x === 'string'și apoi, în aceeași ramură,typeof x === 'number', sau ai o ramură pe care codul nu o poate atinge. Mesajul e un semn că logica are o problemă. - Tablou gol fără tip:
const lista = []într-un context în care TypeScript nu poate deduce tipul (de exemplu ca proprietate într-un obiect) devinenever[]. Elementele lui au tipulnever, decilista[0].numedă eroarea.
Linia din mesaj arată accesul. Treci cu mouse-ul peste variabilă: dacă scrie never, urmărește condițiile de deasupra sau declarația tabloului.
De ce apare: cauzele frecvente
1Tablou gol fără tip într-un obiect
const cos = { produse: [] };
cos.produse.push({ nume: 'a' });const cos: { produse: { nume: string }[] } = { produse: [] };
cos.produse.push({ nume: 'a' });Cu tipul explicit, tabloul nu mai e never[], ci o listă de produse.
2Ramură în care toate cazurile au fost tratate
type Plata = 'card' | 'cash';
function f(p: Plata) {
if (p === 'card') {}
else if (p === 'cash') {}
else { console.log(p.length); }
}type Plata = 'card' | 'cash' | 'transfer';
function f(p: Plata) {
if (p === 'card') {}
else if (p === 'cash') {}
else { console.log(p.length); }
}Pe ultima ramură nu mai rămânea niciun caz. Ori adaugi cazul lipsă în tip, ori ștergi ramura moartă.
3Condiții care se contrazic
function f(x: string | number) {
if (typeof x === 'string' && typeof x === 'number') {
x.toFixed();
}
}function f(x: string | number) {
if (typeof x === 'number') {
x.toFixed();
}
}O valoare nu poate fi simultan text și număr. Condiția corectă e una singură.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2339: Property 'nume' does not exist on type 'never'. Coșul pornește gol, iar produsele se adaugă după. Repară tipul coșului ca programul să afișeze Primul produs: Cafea.
const cos = { client: 'Ana', produse: [] };
cos.produse.push({ nume: 'Cafea', pret: 18 });
console.log(`Primul produs: ${cos.produse[0].nume}`);Primul produs: Cafea
Indiciu
Un tablou gol într-un obiect are nevoie de tip explicit.
Reparația
type Produs = { nume: string; pret: number };
const cos: { client: string; produse: Produs[] } = { client: 'Ana', produse: [] };
cos.produse.push({ nume: 'Cafea', pret: 18 });
console.log(`Primul produs: ${cos.produse[0].nume}`);De ce merge
În obiectul cos, produse: [] nu avea de unde să-și ia tipul, așa că TypeScript l-a dedus ca never[]: o listă în care nu poate exista niciun element. Elementele ei au tipul never, care nu are proprietăți. Cu tipul Produs[], lista acceptă produse, iar cos.produse[0].nume e un string.
Alte forme ale mesajului
error TS2339: Property 'nume' does not exist on type 'never'.error TS2339: Property 'push' does not exist on type 'never'.
Cum o eviți pe viitor
- Dă mereu tip explicit tablourilor goale:
const lista: Produs[] = []. - Când o variabilă devine
neverneașteptat, citește condițiile de deasupra: probabil o ramură e imposibilă. - Folosește
neverintenționat, pentru verificări exhaustive (const _: never = x), nu ca să-l întâlnești din greșeală.
Întrebări frecvente
De ce const lista = [] nu dă mereu never[]?
Pentru o variabilă locală, TypeScript urmărește ce pui în ea după declarație (any[] evolutiv). Ca proprietate într-un obiect sau valoare întoarsă, nu mai are ce urmări și deduce never[]. Tipul explicit rezolvă ambele cazuri.
E rău că variabila e never?
Nu întotdeauna. În default-ul unui switch exhaustiv e exact ce vrei: dovada că ai tratat toate cazurile. Problema apare doar când încerci să folosești valoarea acolo.
Erori înrudite
error TS2322: Type '"crypto"' is not assignable to type 'never'. Ai o verificare exhaustivă (const x: never = valoare în default) și o variantă a uniunii nu e tratată în switch. Mesajul îți spune exact care: adaugă case-ul pentru "crypto". Dacă nu folosești intenționat never, tipul s-a restrâns la nimic din cauza unor verificări contradictorii. error TS2345: Argument of type 'string' is not assignable to parameter of type 'never'. Ai un tablou creat gol într-un obiect ({ produse: [] }) sau într-un loc fără tip, iar TypeScript l-a dedus ca never[]: un tablou în care nu poți pune nimic. Declară tipul elementelor: produse: [] as string[], sau o interfață pentru obiect. error TS2339: Property 'toUpperCase' does not exist on type 'string | number'. Variabila are un tip uniune (string | number), iar metoda există doar pe una dintre variante. Fă narrowing înainte: if (typeof x === "string") x.toUpperCase(); în ramura aceea TypeScript știe că e string. Î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.
