Formations — 1 037 leçons en français

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 devient T | 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 type T dans le corps.

Union avec `undefined`

b: number | undefined autorise la valeur undefined mais 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é.

Lire l'explication détaillée et faire le quiz →

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.