...
Eroare TypeScript · Erori de sintaxă

error TS1385: Function type notation must be parenthesized when used in a union type.

Pe scurt

Ai scris un tip de funcție într-o uniune fără paranteze: string | () => void sau null | (x: number) => number. Pune tipul de funcție între paranteze: string | (() => void).

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

Ce înseamnă

Un tip de funcție ((x: number) => string) se întinde până la final: tot ce urmează după => e considerat tipul întors. Într-o uniune, asta face ordinea ambiguă: null | () => void ar putea însemna o funcție sau null. TypeScript nu ghicește și cere paranteze în jurul tipului de funcție.

Apare des la callback-uri opționale (onClick: null | () => void), la handler-e care pot fi și text (string | (e: Event) => void) și la tablouri de funcții (() => void[] înseamnă de fapt funcție care întoarce void[]; corect e (() => void)[]).

Reparația e mereu aceeași: paranteze în jurul tipului de funcție. Pentru lizibilitate, poți da un nume tipului: type Handler = () => void; și apoi null | Handler.

De ce apare: cauzele frecvente

1Callback care poate lipsi

Greșit
TypeScript
let onSave: null | () => void = null;
Corect
TypeScript
let onSave: null | (() => void) = null;

Parantezele delimitează tipul de funcție în interiorul uniunii.

2Text sau funcție

Greșit
TypeScript
type Eticheta = string | (n: number) => string;
Corect
TypeScript
type Formatter = (n: number) => string;
type Eticheta = string | Formatter;

Un alias pentru tipul de funcție face uniunea clară fără paranteze.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1385: Function type notation must be parenthesized when used in a union type. Un câmp poate avea eticheta fixă (text) sau o funcție care o calculează. Repară tipul ca programul să afișeze Preț: 12.50 lei și Stoc.

Codul care dă eroarea
TypeScript
type Eticheta = string | (valoare: number) => string;
function afiseaza(e: Eticheta, v: number): string {
  return typeof e === 'string' ? e : e(v);
}
console.log(afiseaza((v) => `Preț: ${v.toFixed(2)} lei`, 12.5));
console.log(afiseaza('Stoc', 3));
După reparație, programul afișează
Preț: 12.50 lei
Stoc
Indiciu

Pune tipul de funcție din uniune între paranteze.

Alte forme ale mesajului

  • error TS1386: Constructor type notation must be parenthesized when used in a union type.

Cum o eviți pe viitor

  • Pune mereu tipurile de funcție între paranteze când le combini cu alte tipuri: | (() => void).
  • Dă nume tipurilor de callback folosite des (type Handler = (e: Eveniment) => void).
  • Pentru tablouri de funcții scrie (() => void)[] sau Array<() => void>.
  • Pentru callback-uri opționale în obiecte, preferă onSave?: () => void.

Întrebări frecvente

De ce () => void | null nu dă eroare?

Pentru că e citit ca o funcție care întoarce void | null, nu ca „funcție sau null”. Codul compilează, dar înseamnă altceva. Dacă voiai „funcție sau null”, scrie (() => void) | null.

La intersecții (&) e la fel?

Da, regula e aceeași pentru &: TypeScript dă TS1387 (Function type notation must be parenthesized when used in an intersection type).

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.