error TS2775: Assertions require every name in the call target to be declared with an explicit type annotation.
Ai scris o funcție asserts ca săgeată atribuită unei const fără tip, iar TypeScript nu folosește aserțiunea la apel. Declar-o cu function asigura(v: unknown): asserts v is string { ... } sau dă-i variabilei un tip explicit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O funcție de aserțiune (asserts v is string) îi spune compilatorului: dacă apelul se termină fără excepție, după el v are tipul indicat. Ca să aplice această regulă, TypeScript trebuie să știe tipul funcției înainte să analizeze fluxul de cod, fără să deducă nimic.
Când funcția e o săgeată atribuită unei const fără adnotare (const asigura = (v: unknown): asserts v is string => {...}), tipul variabilei e dedus din inițializare. Pentru aserțiuni asta nu e suficient, așa că apelul asigura(x) dă TS2775, iar x rămâne nerestrâns (de obicei vezi și TS18046: 'x' is of type 'unknown' pe linia următoare).
Regula se aplică fiecărui nume din apel: și la util.asigura(x), atât util cât și asigura trebuie să aibă tip explicit.
De ce apare: cauzele frecvente
1Funcție asserts scrisă ca săgeată fără tip pe variabilă
const asiguraText = (v: unknown): asserts v is string => {
if (typeof v !== 'string') throw new Error();
};function asiguraText(v: unknown): asserts v is string {
if (typeof v !== 'string') throw new Error();
}O declarație function are tip cunoscut direct din semnătură, deci aserțiunea poate fi folosită la apel.
2Varianta cu săgeată, dar cu tip explicit
const asiguraNumar = (v: unknown): asserts v is number => {
if (typeof v !== 'number') throw new Error();
};const asiguraNumar: (v: unknown) => asserts v is number = (v) => {
if (typeof v !== 'number') throw new Error();
};Adnotarea pe variabilă face tipul explicit, fără inferență, ceea ce cere regula aserțiunilor.
3Aserțiune într-un obiect fără tip
const validari = {
text(v: unknown): asserts v is string {
if (typeof v !== 'string') throw new Error();
},
};
validari.text(x);interface Validari { text(v: unknown): asserts v is string }
const validari: Validari = {
text(v) {
if (typeof v !== 'string') throw new Error();
},
};
validari.text(x);Și validari face parte din ținta apelului, deci are nevoie de tip explicit.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2775: Assertions require every name in the call target to be declared with an explicit type annotation. Funcția asiguraText trebuie să garanteze că intrarea e text, ca după apel să poți folosi toUpperCase. Repar-o ca programul să afișeze SALUT.
const asiguraText = (v: unknown): asserts v is string => {
if (typeof v !== 'string') {
throw new Error('Intrarea nu e text');
}
};
const intrare: unknown = 'salut';
asiguraText(intrare);
console.log(intrare.toUpperCase());SALUT
Indiciu
O declarație function are tipul cunoscut direct din semnătură, fără inferență.
Reparația
function asiguraText(v: unknown): asserts v is string {
if (typeof v !== 'string') {
throw new Error('Intrarea nu e text');
}
}
const intrare: unknown = 'salut';
asiguraText(intrare);
console.log(intrare.toUpperCase());De ce merge
Ca să restrângă tipul după apel, TypeScript trebuie să știe tipul funcției de aserțiune fără să-l deducă. La o săgeată atribuită unei const fără adnotare, tipul e dedus, așa că aserțiunea e ignorată și intrare rămâne unknown. Declarată cu function, semnătura e explicită: după asiguraText(intrare), intrare e string, iar toUpperCase() afișează SALUT.
Cum o eviți pe viitor
- Scrie funcțiile de aserțiune ca declarații
function: e cea mai simplă formă care merge mereu. - Dacă le pui într-un obiect sau într-o clasă, dă obiectului un tip explicit (interfață) sau folosește metode de clasă.
- Când după un apel de aserțiune variabila nu e restrânsă și vezi TS18046 / TS2339, caută TS2775 pe linia apelului.
- Alternativa fără reguli speciale: type guard-uri (
v is string) folosite înif.
Întrebări frecvente
De ce type guard-urile (v is string) merg ca săgeți și aserțiunile nu?
Type guard-urile sunt folosite în condiții (if (esteText(v))), unde tipul funcției poate fi dedus normal. Aserțiunile schimbă tipul după un apel simplu, ca instrucțiune, iar TypeScript are nevoie de tipul lor înainte de analiza fluxului, deci cere adnotări explicite.
Metodele de clasă cu asserts au aceeași problemă?
Nu, dacă instanța are tip cunoscut: const v = new Validator(); v.text(x); merge, pentru că v are tipul clasei. Problema apare la obiecte literale și variabile fără tip.
Erori înrudite
error TS18046: 'e' is of type 'unknown'. Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message). error TS2677: A type predicate's type must be assignable to its parameter's type. Un type guard (x is Tip) poate doar să restrângă tipul parametrului, nu să-l schimbe în ceva fără legătură. Dacă parametrul e string, nu poți spune x is number. Lărgește tipul parametrului (unknown, o uniune) sau corectează tipul din predicat. error TS1196: Catch clause variable type annotation must be 'any' or 'unknown' if specified. Ai scris catch (e: Error). TypeScript nu permite alt tip decât any sau unknown la variabila din catch, pentru că poți arunca orice valoare. Scrie catch (e) sau catch (e: unknown) și verifică apoi cu instanceof Error. Î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.
