...
Eroare TypeScript · Funcții, apeluri și async

error TS2775: Assertions require every name in the call target to be declared with an explicit type annotation.

Pe scurt

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ă

Greșit
TypeScript
const asiguraText = (v: unknown): asserts v is string => {
  if (typeof v !== 'string') throw new Error();
};
Corect
TypeScript
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

Greșit
TypeScript
const asiguraNumar = (v: unknown): asserts v is number => {
  if (typeof v !== 'number') throw new Error();
};
Corect
TypeScript
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

Greșit
TypeScript
const validari = {
  text(v: unknown): asserts v is string {
    if (typeof v !== 'string') throw new Error();
  },
};
validari.text(x);
Corect
TypeScript
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ă tu

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.

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

O declarație function are tipul cunoscut direct din semnătură, fără inferență.

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 în if.

Î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

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