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
: Typequi 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 devientstring | undefined. Ce n'est pas la même chose quenom: 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.
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.