Formations — 1 037 leçons en français

Accueil › TypeScript › satisfies, annoter, ou asserter

satisfies, annoter, ou asserter

Contraintes et inférenceintermediaire

Trois façons de rapprocher une valeur d'un type, et elles ne font pas la même chose.

L'annotation vérifie et remplace

const traductions: Record<string, string> = { fr: "Bonjour", en: "Hello" };

traductions.quelquechose;          // ✅ accepté — le type est devenu Record<string, string>

La conformité est contrôlée, mais la précision est perdue : le type ne sait plus quelles clés existent.

satisfies vérifie et conserve

const traductions = {
  fr: "Bonjour",
  en: "Hello",
} satisfies Record<string, string>;

traductions.fr;                    // ✅ string
traductions.quelquechose;          // ❌ TS2339 — la clé n'existe pas

On garde les deux : la vérification et le type exact.

L'assertion ne vérifie presque rien

const t = { fr: "Bonjour" } as Record<string, string>;
const n = "abc" as unknown as number;      // aveu complet

as demande au compilateur de se taire. Il refuse encore les conversions absurdes — d'où le détour par unknown quand on insiste.

Le cas qui revient le plus

// ❌ une faute de frappe passe
const couleurs: Record<string, string> = { primaire: "#0e7490" };
couleurs.primare;                  // accepté, vaut undefined

// ✅ la faute est attrapée
const couleurs = { primaire: "#0e7490" } satisfies Record<string, string>;
couleurs.primare;                  // ❌ TS2339

L'assertion non nulle

const client = clients.find((c) => c.id === id)!;      // ⚠️ promesse
client.nom;                                             // explose si absent

Le compilateur se taira. undefined arrivera quand même — sans message utile.

Les termes à connaître

satisfies

valeur satisfies Forme vérifie que la valeur respecte la forme sans élargir son type. On garde la précision et la vérification.

Annotation

const x: Forme = … vérifie et remplace le type par la forme. On perd la précision de la valeur.

Assertion

valeur as Forme ne vérifie presque rien : elle demande au compilateur de se taire. À réserver aux cas où l'on sait quelque chose qu'il ne peut pas savoir.

Double assertion

x as unknown as T contourne même le garde-fou de l'assertion. C'est un aveu qu'il faut commenter.

Assertion non nulle

Le ! qui affirme qu'une valeur n'est ni null ni undefined. Une promesse non vérifiée, et la cause la plus fréquente des erreurs « of undefined » en production.

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.