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

error TS2345: Argument of type 'string' is not assignable to parameter of type 'never'.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul pare ciudat: de ce un parametru de tip never? Pentru că metoda apelată e push pe un tablou de tip never[], iar push primește elemente de tipul tabloului. never[] înseamnă „tablou în care nu poate exista niciun element”.

Asta se întâmplă când creezi un tablou gol fără tip într-un loc în care TypeScript nu-l poate „lărgi” pe parcurs: ca proprietate într-un obiect literal ({ produse: [] }), ca valoare întoarsă de o funcție, sau într-un tip dedus dintr-o constantă. (O variabilă simplă let a = [] are o regulă specială și își deduce tipul din push-urile următoare.)

Repari spunând ce va conține tabloul: produse: [] as string[], o interfață pentru obiect (interface Cos { produse: string[] }) sau un tip generic explicit (new Array<string>(), useState<string[]>([]) în React).

De ce apare: cauzele frecvente

1Tablou gol într-un obiect literal

Greșit
TypeScript
const cos = { client: "Ana", produse: [] };
cos.produse.push("pâine");
Corect
TypeScript
const cos = { client: "Ana", produse: [] as string[] };
cos.produse.push("pâine");

as string[] spune tipul elementelor, așa că push acceptă string-uri.

2Mai bine: interfață pentru obiect

Greșit
TypeScript
const comanda = { id: 1, linii: [] };
comanda.linii.push({ produs: "Pix", buc: 2 });
Corect
TypeScript
interface Linie { produs: string; buc: number }
const comanda: { id: number; linii: Linie[] } = { id: 1, linii: [] };
comanda.linii.push({ produs: "Pix", buc: 2 });

Cu tipul declarat, tabloul gol e de la început Linie[].

3Funcție care întoarce un tablou gol

Greșit
TypeScript
function initial() {
  return { erori: [] };
}
initial().erori.push("lipsă email");
Corect
TypeScript
function initial(): { erori: string[] } {
  return { erori: [] };
}
initial().erori.push("lipsă email");

Tipul de return dă tipul tabloului.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2345: Argument of type '{ text: string; gata: boolean; }' is not assignable to parameter of type 'never', pentru că lista de sarcini a fost creată goală, fără tip. Declară tipul tabloului, ca programul să afișeze Sarcini: 2, terminate: 1.

Codul care dă eroarea
TypeScript
const proiect = { nume: "Site", sarcini: [] };
proiect.sarcini.push({ text: "Design", gata: true });
proiect.sarcini.push({ text: "Cod", gata: false });
const gata = proiect.sarcini.filter((s) => s.gata).length;
console.log(`Sarcini: ${proiect.sarcini.length}, terminate: ${gata}`);
După reparație, programul afișează
Sarcini: 2, terminate: 1
Indiciu

Definește o interfață Sarcina și spune că sarcini e Sarcina[].

Alte forme ale mesajului

  • error TS2345: Argument of type '{ produs: string; buc: number; }' is not assignable to parameter of type 'never'.
  • error TS2322: Type 'string' is not assignable to type 'never'.

Cum o eviți pe viitor

  • Nu lăsa niciodată un [] gol fără tip într-un obiect sau într-un return: scrie tipul elementelor.
  • Descrie obiectele cu stare (coș, formular, raport) cu o interfață și tipează variabila cu ea.
  • În React, dă tipul la useState<string[]>([]); altfel primești aceeași eroare la setLista([...lista, x]).

Întrebări frecvente

De ce let a = []; a.push(1) merge?

Pentru variabile declarate fără tip, TypeScript folosește „evolving arrays”: tipul tabloului se deduce din ce adaugi după. Regula nu se aplică proprietăților din obiecte literale.

E la fel cu eroarea „Type 'string' is not assignable to type 'never'”?

Cauza e diferită: aceea apare de obicei la verificări exhaustive cu never în switch. Aici never vine dintr-un tablou gol fără tip.

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.