Accueil › TypeScript › Optionnels, valeurs par défaut et rest
Optionnels, valeurs par défaut et rest
Typer les fonctionsdebutant
Trois mécanismes rendent un argument facultatif, et ils ne font pas la même chose.
function creerUrl(base: string, page?: number) {
// page : number | undefined
return page === undefined ? base : `${base}?p=${page}`;
}
function creerUrl2(base: string, page = 1) {
// page : number — la valeur par défaut a retiré undefined
return `${base}?p=${page}`;
}
function joindre(separateur: string, ...morceaux: string[]) {
return morceaux.join(separateur);
}
Le ? élargit le type dans le corps : vous devrez traiter undefined. La
valeur par défaut, elle, le referme : dans le corps, page est un number.
Le rest collecte le reste et son type est toujours un tableau.
Un optionnel n'est pas une union avec undefined
function a(x: number, y?: number) {}
function b(x: number, y: number | undefined) {}
a(1); // accepté
b(1); // TS2554: Expected 2 arguments, but got 1.
b(1, undefined); // accepté
Dans les deux corps, y vaut number | undefined. La différence n'est pas
dans le type du paramètre, elle est dans l'arité. ? autorise l'omission ;
l'union exige qu'on passe quelque chose, quitte à ce que ce soit undefined.
Ce choix est une décision de conception. L'union force l'appelant à écrire qu'il n'a pas de valeur, et rend donc l'oubli impossible — ce qui est exactement ce qu'on veut pour un paramètre qu'on vient d'ajouter à une fonction déjà appelée en vingt endroits.
Les termes à connaître
- Paramètre optionnel
Un paramètre suivi de
?. L'appelant peut l'omettre, et son type dans le corps devientT | undefined.- Valeur par défaut
Une expression évaluée à chaque appel où l'argument vaut
undefined. Elle rend le paramètre facultatif à l'appel tout en gardant le typeTdans le corps.- Union avec `undefined`
b: number | undefinedautorise la valeurundefinedmais pas l'omission de l'argument. Ce n'est pas un paramètre optionnel.- Paramètre rest
Un dernier paramètre préfixé de
..., dont le type est un tableau ou un tuple. Il collecte tous les arguments restants.- Tuple de paramètres
Un rest typé par un tuple —
...args: [string, number]— qui fixe l'arité et le type de chaque place. C'est ainsi qu'on décrit une liste de paramètres comme un type.- Arité
L'intervalle d'arguments qu'une signature accepte, du nombre de paramètres obligatoires au total. Un rest le rend illimité.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.