error TS1385: Function type notation must be parenthesized when used in a union type.
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
let onSave: null | () => void = null;let onSave: null | (() => void) = null;Parantezele delimitează tipul de funcție în interiorul uniunii.
2Text sau funcție
type Eticheta = string | (n: number) => string;type Formatter = (n: number) => string;
type Eticheta = string | Formatter;Un alias pentru tipul de funcție face uniunea clară fără paranteze.
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.
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));Preț: 12.50 lei Stoc
Indiciu
Pune tipul de funcție din uniune între paranteze.
Reparația
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));De ce merge
Fără paranteze, nu e clar unde se termină tipul de funcție în uniune, așa că TypeScript le cere. Cu string | ((valoare: number) => string), Eticheta e fie un text, fie o funcție. typeof e === 'string' separă cazurile: textul e afișat direct, iar funcția e apelată cu valoarea 12.5.
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)[]sauArray<() => 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
error TS1110: Type expected. După : (sau în < >) TypeScript aștepta un tip, dar a găsit altceva: nimic (let x: = 5), o valoare în loc de tip, sau un operator. Scrie tipul (let x: number = 5) sau șterge : și lasă tipul să fie dedus. error TS2722: Cannot invoke an object which is possibly 'undefined'. Apelezi o funcție care poate lipsi (un callback opțional, o metodă opțională dintr-o interfață). Verifică întâi că există sau folosește apelul opțional: onGata?.(); ori dă-i o valoare implicită. error TS2349: This expression is not callable. Pui paranteze () după ceva care nu e funcție: o proprietate (length), un getter, un număr sau o variabilă care ascunde o funcție cu același nume. Scoate parantezele sau apelează funcția corectă. Î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.
