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

error TS2339: Property 'length' does not exist on type 'never'.

Pe scurt

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) devine never[]. Elementele lui au tipul never, deci lista[0].nume dă 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

Greșit
TypeScript
const cos = { produse: [] };
cos.produse.push({ nume: 'a' });
Corect
TypeScript
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

Greșit
TypeScript
type Plata = 'card' | 'cash';
function f(p: Plata) {
  if (p === 'card') {}
  else if (p === 'cash') {}
  else { console.log(p.length); }
}
Corect
TypeScript
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

Greșit
TypeScript
function f(x: string | number) {
  if (typeof x === 'string' && typeof x === 'number') {
    x.toFixed();
  }
}
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
const cos = { client: 'Ana', produse: [] };
cos.produse.push({ nume: 'Cafea', pret: 18 });
console.log(`Primul produs: ${cos.produse[0].nume}`);
După reparație, programul afișează
Primul produs: Cafea
Indiciu

Un tablou gol într-un obiect are nevoie de tip explicit.

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 never neașteptat, citește condițiile de deasupra: probabil o ramură e imposibilă.
  • Folosește never intenț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

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