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 Formevé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 Formene 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 Tcontourne 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 ninullniundefined. Une promesse non vérifiée, et la cause la plus fréquente des erreurs « of undefined » en production.
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.