Formations — 1 037 leçons en français

Accueil › TypeScript › Premier fichier typé

Premier fichier typé

Démarrer avec TypeScriptdebutant

Un fichier .ts est un fichier .js auquel on ajoute des annotations. Voici le vocabulaire qui couvre la majorité du code écrit au quotidien.

// Alias de type : un nom donné à une forme
type Statut = "attente" | "payee" | "annulee";

type Commande = {
  id: number;
  statut: Statut;
  remise?: number;        // propriété optionnelle
  lignes: { prix: number; quantite: number }[];
};

// Paramètres et retour annotés : c'est le contrat
function total(commande: Commande): number {
  const brut = commande.lignes.reduce((s, l) => s + l.prix * l.quantite, 0);
  return brut * (1 - (commande.remise ?? 0));
}

total({ id: 1, statut: "payee", lignes: [{ prix: 10, quantite: 2 }] });
total({ id: 2, statut: "en_cours", lignes: [] });
// TS2322: Type '"en_cours"' is not assignable to type 'Statut'.

Trois choses se passent dans ces vingt lignes.

Statut est une union de littéraux : trois valeurs possibles, pas une de plus. TypeScript vérifie l'orthographe de chaque chaîne.

remise? est optionnelle : lue, elle vaut number | undefined, et le ?? 0 est ce qui rend le calcul valide.

Le : number après la parenthèse n'est pas décoratif. Sans lui, le type de retour est déduit du corps ; avec lui, le corps doit respecter le contrat, et l'erreur sort au bon endroit.

Les termes à connaître

Annotation

Le : Type qui suit un nom. Sur un paramètre, elle contraint les appelants ; sur une variable, elle contraint les affectations suivantes.

Type de retour explicite

L'annotation après la parenthèse fermante. Elle fait signaler l'erreur dans la fonction fautive au lieu de chez son appelant.

Alias de type

type Nom = … : un nom donné à une forme. Il accepte n'importe quel type — objet, union, fonction, tableau — là où une interface se limite aux formes d'objets.

Union

A | B : la valeur est l'un ou l'autre. Avant de l'utiliser, il faut affiner pour savoir lequel, sinon seules les opérations communes sont permises.

Propriété optionnelle

nom?: string : la clé peut être absente, et le type lu devient string | undefined. Ce n'est pas la même chose que nom: string | undefined, qui exige la clé.

unknown

Le type « valeur dont on ne sait rien ». On ne peut rien en faire sans l'affiner — c'est exactement ce qu'on veut à l'entrée, et c'est le contraire de any.

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.