Formations — 1 037 leçons en français

Accueil › TypeScript › interface ou type

interface ou type

Objets, interfaces et aliasdebutant

Deux façons de nommer la forme d'un objet, et elles sont presque interchangeables.

interface Client {
  id: number;
  nom: string;
}

type Client2 = {
  id: number;
  nom: string;
};

Les deux sont acceptées partout où l'autre l'est, parce que TypeScript est structurel : la compatibilité se décide sur la forme, jamais sur le nom.

function afficher(c: Client) {
  console.log(c.nom);
}

const brut: Client2 = { id: 1, nom: "Anne" };
afficher(brut); // accepté : même forme

Si vous venez de Java ou de C#, c'est la surprise du chapitre. Là-bas, une classe doit déclarer qu'elle implémente une interface. Ici, elle n'a rien à déclarer : si elle a les bons membres, elle convient.

Ce qui les sépare vraiment

Deux différences réelles, le reste est du goût :

// 1. L'alias nomme n'importe quel type, l'interface non
type Statut = "brouillon" | "publie";
type Paire = [number, number];

// 2. Deux interfaces de même nom fusionnent
interface Fenetre { titre: string }
interface Fenetre { largeur: number }
// Fenetre a maintenant titre ET largeur

La fusion est utile pour étendre le type d'une bibliothèque. Dans votre propre code, elle transforme un doublon accidentel en type silencieusement enrichi — là où un alias dupliqué aurait levé une erreur.

Convention répandue, et c'est celle de ce cours : interface pour les formes d'objets, type pour tout le reste.

Les termes à connaître

Typage structurel

La compatibilité se décide sur la forme, pas sur le nom. Une valeur qui possède les propriétés attendues, du bon type, est acceptée — même si son type a été déclaré ailleurs et autrement.

Alias de type

type X = … donne un nom à n'importe quel type : un objet, une union, un tuple, une primitive, une fonction. C'est un nom, pas une déclaration de structure.

interface

interface X { … } déclare la forme d'un objet. Elle accepte extends, et plusieurs déclarations du même nom fusionnent au lieu de se contredire.

Fusion de déclarations

Deux interface Client dans la même portée produisent une seule interface réunissant leurs membres. Deux type Client produisent une erreur de duplication.

Propriété excédentaire

Une clé présente dans un littéral d'objet mais absente du type visé. TypeScript la refuse, bien que le typage structurel l'autoriserait.

Élargissement du littéral

Affecter un littéral à une variable sans annotation fait perdre le statut de littéral frais, et avec lui la vérification des propriétés excédentaires.

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.