error TS1016: A required parameter cannot follow an optional parameter.
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 trimiteundefinedca 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
function salut(titlu?: string, nume: string) {
return `${titlu ?? ""} ${nume}`;
}function salut(nume: string, titlu?: string) {
return `${titlu ?? ""} ${nume}`;
}Cu opționalul la final, salut("Ana") e neambiguu.
2Valoare implicită în loc de ?
function pret(moneda?: string, suma: number) {}function pret(moneda = "RON", suma: number) {}
pret(undefined, 10);Un parametru cu valoare implicită poate sta înaintea celor obligatorii.
3Multe opțiuni
function cauta(pagina?: number, marime?: number, text: string) {}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ă 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.
function eticheta(titlu?: string, nume: string): string {
return titlu ? `${titlu} ${nume}` : nume;
}
console.log(eticheta("Dr.", "Popescu"));
console.log(eticheta(undefined, "Ionescu"));Dr. Popescu Ionescu
Indiciu
Pune nume primul și titlu? al doilea, apoi schimbă ordinea argumentelor la primul apel.
Reparația
function eticheta(nume: string, titlu?: string): string {
return titlu ? `${titlu} ${nume}` : nume;
}
console.log(eticheta("Popescu", "Dr."));
console.log(eticheta("Ionescu"));De ce merge
Argumentele se potrivesc cu parametrii în ordine, deci un parametru opțional nu poate fi urmat de unul obligatoriu. Cu nume primul, al doilea argument poate lipsi: eticheta("Ionescu") lasă titlu nedefinit și funcția întoarce doar numele. La primul apel, titlul Dr. vine acum al doilea și se pune în fața numelui, ca înainte.
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
error TS2554: Expected 2 arguments, but got 1. Ai apelat o funcție cu alt număr de argumente decât are parametri obligatorii. Trimite toate argumentele cerute sau, dacă unul chiar poate lipsi, fă parametrul opțional (nume?: tip) ori dă-i o valoare implicită. error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'. Trimiți unei funcții o valoare care poate fi undefined (câmp opțional, find(), Map.get()), dar parametrul acceptă doar string. Verifică valoarea înainte de apel, dă-i o valoare implicită cu ?? sau, dacă funcția poate trata lipsa, fă parametrul opțional. error TS2393: Duplicate function implementation. Ai două funcții cu același nume și corp în același domeniu (sau în două fișiere script). Șterge una, redenumește-o, sau, dacă voiai supraîncărcare, scrie semnăturile fără corp și o singură implementare. Î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.
