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

error TS1016: A required parameter cannot follow an optional parameter.

Pe scurt

Ai pus un parametru obligatoriu după unul opțional (cu ?). Mută parametrii opționali la sfârșitul listei sau dă-i celui opțional o valoare implicită ori tipul x: T | undefined.

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

Ce înseamnă

Argumentele unei funcții se potrivesc cu parametrii după poziție. Dacă primul parametru e opțional și al doilea obligatoriu, la un apel cu un singur argument nu se poate ști dacă ai vrut să sari peste primul. De aceea TypeScript cere ca toți parametrii cu ? să fie la final.

Eroarea apare la parametrul obligatoriu care vine după cel opțional. Reparațiile posibile:

  • reordonezi parametrii, punând opționalii la urmă (și actualizezi apelurile);
  • dai parametrului din față o valoare implicită (moneda = "RON"), caz în care e permis să stea în față, iar apelantul poate trimite undefined ca să folosească valoarea implicită;
  • treci la un singur obiect de opțiuni, mai ușor de citit când sunt multe valori.

De ce apare: cauzele frecvente

1Opționalul înaintea obligatoriului

Greșit
TypeScript
function salut(titlu?: string, nume: string) {
  return `${titlu ?? ""} ${nume}`;
}
Corect
TypeScript
function salut(nume: string, titlu?: string) {
  return `${titlu ?? ""} ${nume}`;
}

Cu opționalul la final, salut("Ana") e neambiguu.

2Valoare implicită în loc de ?

Greșit
TypeScript
function pret(moneda?: string, suma: number) {}
Corect
TypeScript
function pret(moneda = "RON", suma: number) {}
pret(undefined, 10);

Un parametru cu valoare implicită poate sta înaintea celor obligatorii.

3Multe opțiuni

Greșit
TypeScript
function cauta(pagina?: number, marime?: number, text: string) {}
Corect
TypeScript
function cauta(text: string, opt: { pagina?: number; marime?: number } = {}) {}

Un obiect de opțiuni elimină problema ordinii și face apelul ușor de citit.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS1016: A required parameter cannot follow an optional parameter. Mută parametrul opțional la sfârșit (și actualizează apelurile) ca programul să afișeze Dr. Popescu și apoi Ionescu.

Codul care dă eroarea
TypeScript
function eticheta(titlu?: string, nume: string): string {
  return titlu ? `${titlu} ${nume}` : nume;
}
console.log(eticheta("Dr.", "Popescu"));
console.log(eticheta(undefined, "Ionescu"));
După reparație, programul afișează
Dr. Popescu
Ionescu
Indiciu

Pune nume primul și titlu? al doilea, apoi schimbă ordinea argumentelor la primul apel.

Cum o eviți pe viitor

  • Scrie întâi parametrii obligatorii, apoi pe cei opționali.
  • Când o funcție are mai mult de două-trei opțiuni, primește-le într-un obiect.
  • Preferă valorile implicite (= 0) în locul lui ? urmat de verificări manuale.
  • La reordonarea parametrilor, lasă TypeScript să-ți arate toate apelurile care trebuie actualizate.

Întrebări frecvente

Și parametrii rest?

Parametrul rest (...valori: number[]) trebuie să fie ultimul dintre toți, după cei opționali. E o regulă separată, cu alt mesaj (TS1014).

Care e diferența dintre x?: number și x: number | undefined?

Cu ? apelantul poate omite argumentul. Cu number | undefined trebuie să-l scrie, chiar dacă scrie undefined. A doua formă e permisă și în fața parametrilor obligatorii.

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.