Formations — 1 037 leçons en français

Accueil › TypeScript › Décrire un type de fonction

Décrire un type de fonction

Typer les fonctionsdebutant

Un type de fonction décrit ce qu'on peut faire d'une fonction, pas comment elle est écrite.

type Comparateur = (a: number, b: number) => number;

const croissant: Comparateur = (a, b) => a - b;
const decroissant: Comparateur = (x, y) => y - x;

Les paramètres de croissant n'ont pas d'annotation : l'alias les fournit par typage contextuel. Et decroissant prouve que les noms du type sont de la documentation — seules les positions et les types déterminent la compatibilité.

Deux écritures, deux usages

// Alias : la forme par défaut, concise
type Formateur = (valeur: number) => string;

// Interface avec signature d'appel : quand la fonction porte des propriétés
interface Validateur {
  (valeur: string): boolean;
  message: string;
}

const nonVide: Validateur = Object.assign(
  (valeur: string) => valeur.trim() !== "",
  { message: "champ requis" },
);

La signature d'appel sert exactement à cela : décrire un objet qui est à la fois appelable et porteur de données. Une fonction en JavaScript étant un objet, le cas est fréquent — un validateur avec son message, un composant avec ses valeurs par défaut.

Les termes à connaître

Type de fonction

La forme (a: number, b: number) => number, écrite dans un alias ou en ligne. Les noms de paramètres y sont de la documentation — seules les positions comptent.

Signature d'appel

La même description, écrite dans une interface sous la forme (a: number): number. Elle permet d'ajouter des propriétés à une fonction.

Syntaxe méthode

gerer(e: Evenement): void dans un type ou une interface. Ses paramètres sont vérifiés de façon bivariante, même sous strict.

Syntaxe propriété

gerer: (e: Evenement) => void. Ses paramètres sont vérifiés de façon contravariante dès que strictFunctionTypes est actif.

Contravariance

Un consommateur accepte d'être remplacé par un consommateur plus tolérant, jamais plus exigeant. Une fonction qui prend string | number remplace une fonction qui prend string.

Bivariance

La vérification laxiste qui accepte les deux sens. Conservée pour les méthodes, parce que des types comme Array<T> en dépendent.

Signature de construction

new (nom: string) => Client, le type d'une fonction appelable avec new. Utile pour typer une fabrique qui reçoit une classe.

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.